Properties
| Name | Type | Description |
|---|---|---|
| html | string | The html content of the email |
| plaintext | string | The plain text content of the email |
| subject | string | The subject line of the email, tags can be used like in the message to personalize the subject |
| from | string | The name and email of the sender, can be just the email if no name is specified, see below for format |
| reply | string | The name and email of the sender, can be just the email if no name is specified, see below for format |
| callback_url | string | Callback URL to get status reports |
| userref | string | Add your own custom reference to be passed back to the provided callback URL |
| tags | array | A list of string tags, which will be replaced with the tag values for each recipient, if used remember to also add tagvalues to all recipients |
| recipients | array | List of email addresses to receive the email |
| attachments | array | A list of base64 encoded files to be attached to the email |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/gatewayapi/main/json-schema/gatewayapi-post-rest-email-request-schema.json",
"title": "PostRestEmailRequest",
"x-generated": "2026-10-27",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/_ae-authored/gatewayapi-openapi-generated.yml#/components/schemas/PostRestEmailRequest",
"type": "object",
"properties": {
"html": {
"type": "string",
"description": "The html content of the email"
},
"plaintext": {
"type": "string",
"description": "The plain text content of the email"
},
"subject": {
"type": "string",
"description": "The subject line of the email, tags can be used like in the message to personalize the subject"
},
"from": {
"type": "string",
"description": "The name and email of the sender, can be just the email if no name is specified, see below for format"
},
"reply": {
"type": "string",
"description": "The name and email of the sender, can be just the email if no name is specified, see below for format"
},
"callback_url": {
"type": "string",
"description": "Callback URL to get status reports"
},
"userref": {
"type": "string",
"description": "Add your own custom reference to be passed back to the provided callback URL"
},
"tags": {
"type": "array",
"description": "A list of string tags, which will be replaced with the tag values for each recipient, if used remember to also add tagvalues to all recipients"
},
"recipients": {
"type": "array",
"description": "List of email addresses to receive the email"
},
"attachments": {
"type": "array",
"description": "A list of base64 encoded files to be attached to the email"
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/gatewayapi-post-rest-email-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.