SpacePost is an MCP server published by dev.spacepost, hosted at api.spacepost.dev. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 46 tools, including list_emails, send_email, send_batch_emails, get_email, update_email.
Send email and manage domains, contacts and webhooks on SpacePost, the Resend-compatible email API.
10 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List emails. Returns sent and scheduled emails, newest first, without bodies. Requires a `full_access` API key. API: `GET /emails` (operationId `listEmails`, Emails).
| Parameter | Type | Description |
|---|---|---|
| after | string | Return items older than this id (next page). Cannot be combined with `before`. |
| limit | integer | Number of items to return. |
| before | string | Return items newer than this id (previous page). Cannot be combined with `after`. |
{
"name": "list_emails",
"title": "List emails",
"description": "List emails.\n\nReturns sent and scheduled emails, newest first, without bodies.\n\nRequires a `full_access` API key. API: `GET /emails` (operationId `listEmails`, Emails).",
"inputSchema": {
"type": "object",
"properties": {
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of items to return."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
},
"annotations": {
"title": "List emails",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Send an email. Validates and queues one email. Each recipient counts towards your quota. Use `scheduled_at` to send later (up to 30 days ahead). Pass `tenant_id` to send on behalf of a tenant (not needed when the `from` domain belongs to one). Fails with `422` if `tenant_id` conflicts with the domain's tenant, `403 sending_paused` if the tenant is paused and `429 daily_quota_exceeded` if it reached its daily cap. Pass `tracking` (`{ open?, click? }`) to override the domain's open/click tracking for this email only; an omitted key keeps the domain setting. `from` must be on a verified domain (e.g. "Acme <hi@acme.com>"); call list_domains to find one. Provide `html`, `text` or both. Send to delivered@test.spacepost.dev (or bounced@ / complained@) to test without sending real mail. Delivered email cannot be recalled: confirm recipients and content with the user when unsure. Pass `idempotency_key` when retrying so the email is not sent twice. Request body: Either `html` or `text` is required. `reply_to` is also accepted as `replyTo` and `scheduled_at` as `scheduledAt`. Works with a `sending_access` or `full_access` API key. API: `POST /emails` (operationId `sendEmail`, Emails).
| Parameter | Type | Description |
|---|---|---|
| cc | any | |
| to * | any | |
| bcc | any | |
| from * | string | An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains. |
| html | string | |
| tags |
Send batch emails. Sends up to 100 emails in one call. All-or-nothing, if any email is invalid none are sent. Attachments, `scheduled_at` and a per-email `tenant_id` and a per-email `tracking` override are supported; the paused-tenant and tenant-cap errors apply to the whole batch. Put the emails in `body` as an array. Prefer send_email for a single message. Works with a `sending_access` or `full_access` API key. API: `POST /emails/batch` (operationId `sendBatchEmails`, Emails).
| Parameter | Type | Description |
|---|---|---|
| body * | array | The JSON request body. |
| idempotency_key | string | A unique key (1 to 256 characters) that makes the request safe to retry for 24 hours. |
{
"name": "send_batch_emails",
"title": "Send batch emails",
"description": "Send batch emails.\n\nSends up to 100 emails in one call. All-or-nothing, if any email is invalid none are sent. Attachments, `scheduled_at` and a per-email `tenant_id` and a per-email `tracking` override are supported; the paused-tenant and tenant-cap errors apply to the whole batch.\n\nPut the emails in `body` as an array. Prefer send_email for a single message.\n\nWorks with a `sending_access` or `full_access` API key. API: `POST /emails/batch` (operationId `sendBatchEmails`, Emails).",
"inputSchema": {
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "array",
"items": {
"type": "object",
"required": [
"from",
"to",
"subject"
],
"properties": {
"cc": {
"oneOf": [
{
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
{
"type": "array",
"items": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"maxItems": 50,
"minItems": 1
}
]
},
"to": {
"oneOf": [
{
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
{
"type": "array",
"items": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"maxItems": 50,
"minItems": 1
}
]
},
"bcc": {
"oneOf": [
{
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
{
"type": "array",
"items": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"maxItems": 50,
"minItems": 1
}
]
},
"from": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"html": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 256
},
"value": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 256
}
}
},
"maxItems": 50
},
"text": {
"type": "string"
},
"headers": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"subject": {
"type": "string",
"maxLength": 998,
"minLength": 1
},
"reply_to": {
"oneOf": [
{
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
{
"type": "array",
"items": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"maxItems": 50,
"minItems": 1
}
]
},
"tracking": {
"type": "object",
"properties": {
"open": {
"type": "boolean",
"description": "Track opens (adds a tracking pixel and `email.opened` events)."
},
"click": {
"type": "boolean",
"description": "Track link clicks (rewrites links and adds `email.clicked` events)."
}
},
"description": "SpacePost extension. Overrides the sending domain's open/click tracking for this email only; an omitted key falls back to the domain setting (`PATCH /domains/{id}`). Lets a platform opt individual customers into open tracking on a shared domain.",
"additionalProperties": false
},
"tenant_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Platform mode. Our tenant id or your `external_id`. Optional when the `from` domain belongs to a tenant; a conflict with the domain's tenant is a 422."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"required": [
"filename"
],
"properties": {
"path": {
"type": "string",
"format": "uri",
"description": "A public URL fetched at send time."
},
"content": {
"type": "string",
"description": "Base64-encoded file content."
},
"filename": {
"type": "string",
"maxLength": 255
},
"content_id": {
"type": "string",
"description": "Content-ID for inline images (`cid:`)."
},
"content_type": {
"type": "string",
"examples": [
"application/pdf"
]
}
},
"description": "Provide exactly one of `content` or `path`."
},
"maxItems": 50
},
"scheduled_at": {
"type": "string",
"examples": [
"in 1 hour",
"2026-10-30T09:00:00Z"
],
"description": "ISO 8601 date-time or natural language such as \"in 1 hour\" or \"in 2 days\". At most 30 days ahead."
}
},
"description": "Either `html` or `text` is required. `reply_to` is also accepted as `replyTo` and `scheduled_at` as `scheduledAt`."
},
"maxItems": 100,
"minItems": 1,
"description": "The JSON request body."
},
"idempotency_key": {
"type": "string",
"examples": [
"welcome-user-4821"
],
"maxLength": 256,
"minLength": 1,
"description": "A unique key (1 to 256 characters) that makes the request safe to retry for 24 hours."
}
}
},
"annotations": {
"title": "Send batch emails",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Retrieve an email. Requires a `full_access` API key. API: `GET /emails/{id}` (operationId `getEmail`, Emails).
| Parameter | Type | Description |
|---|---|---|
| id * | string | The email id. |
{
"name": "get_email",
"title": "Retrieve an email",
"description": "Retrieve an email.\n\nRequires a `full_access` API key. API: `GET /emails/{id}` (operationId `getEmail`, Emails).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "The email id."
}
}
},
"annotations": {
"title": "Retrieve an email",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Reschedule an email. Changes `scheduled_at` of an email that is still `scheduled`. Requires a `full_access` API key. API: `PATCH /emails/{id}` (operationId `updateEmail`, Emails).
| Parameter | Type | Description |
|---|---|---|
| id * | string | The email id. |
| scheduled_at * | string | ISO 8601 date-time or natural language such as "in 1 hour" or "in 2 days". At most 30 days ahead. |
{
"name": "update_email",
"title": "Reschedule an email",
"description": "Reschedule an email.\n\nChanges `scheduled_at` of an email that is still `scheduled`.\n\nRequires a `full_access` API key. API: `PATCH /emails/{id}` (operationId `updateEmail`, Emails).",
"inputSchema": {
"type": "object",
"required": [
"id",
"scheduled_at"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "The email id."
},
"scheduled_at": {
"type": "string",
"examples": [
"in 1 hour",
"2026-10-30T09:00:00Z"
],
"description": "ISO 8601 date-time or natural language such as \"in 1 hour\" or \"in 2 days\". At most 30 days ahead."
}
}
},
"annotations": {
"title": "Reschedule an email",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Cancel a scheduled email. Requires a `full_access` API key. API: `POST /emails/{id}/cancel` (operationId `cancelEmail`, Emails).
| Parameter | Type | Description |
|---|---|---|
| id * | string | The email id. |
{
"name": "cancel_email",
"title": "Cancel a scheduled email",
"description": "Cancel a scheduled email.\n\nRequires a `full_access` API key. API: `POST /emails/{id}/cancel` (operationId `cancelEmail`, Emails).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "The email id."
}
}
},
"annotations": {
"title": "Cancel a scheduled email",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}List domains. Requires a `full_access` API key. API: `GET /domains` (operationId `listDomains`, Domains).
| Parameter | Type | Description |
|---|---|---|
| after | string | Return items older than this id (next page). Cannot be combined with `before`. |
| limit | integer | Number of items to return. |
| before | string | Return items newer than this id (previous page). Cannot be combined with `after`. |
{
"name": "list_domains",
"title": "List domains",
"description": "List domains.\n\nRequires a `full_access` API key. API: `GET /domains` (operationId `listDomains`, Domains).",
"inputSchema": {
"type": "object",
"properties": {
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of items to return."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
},
"annotations": {
"title": "List domains",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a domain. Registers a domain and returns the DNS records to add (three DKIM CNAMEs, plus MX and SPF on the MAIL FROM subdomain). Domain names are globally unique. The number of domains is limited by your plan (Free 3, Pro 10, Scale 1,000). The response lists the DNS records (DKIM CNAMEs, MAIL FROM MX and SPF TXT) the user must add at their DNS provider; afterwards call verify_domain and then get_domain to see the new status. DNS changes can take minutes to hours. Requires a `full_access` API key. API: `POST /domains` (operationId `createDomain`, Domains).
| Parameter | Type | Description |
|---|---|---|
| name * | string | Domain or subdomain you own. Lower-cased. |
| region | string | Accepted for compatibility. The region is chosen by the platform and returned on the domain. |
| tenant_id | string | Platform mode. Make the domain tenant-owned (our tenant id or your `external_id`). Mail from it is attributed to that tenant. |
| custom_return_path | string | Subdomain used for the custom MAIL FROM (bounce handling and SPF). |
{
"name": "create_domain",
"title": "Create a domain",
"description": "Create a domain.\n\nRegisters a domain and returns the DNS records to add (three DKIM CNAMEs, plus MX and SPF on the MAIL FROM subdomain).\nDomain names are globally unique. The number of domains is limited by your plan (Free 3, Pro 10, Scale 1,000).\n\nThe response lists the DNS records (DKIM CNAMEs, MAIL FROM MX and SPF TXT) the user must add at their DNS provider; afterwards call verify_domain and then get_domain to see the new status. DNS changes can take minutes to hours.\n\nRequires a `full_access` API key. API: `POST /domains` (operationId `createDomain`, Domains).",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"examples": [
"acme.com"
],
"description": "Domain or subdomain you own. Lower-cased."
},
"region": {
"type": "string",
"description": "Accepted for compatibility. The region is chosen by the platform and returned on the domain."
},
"tenant_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Platform mode. Make the domain tenant-owned (our tenant id or your `external_id`). Mail from it is attributed to that tenant."
},
"custom_return_path": {
"type": "string",
"default": "send",
"pattern": "^[a-z0-9-]{1,63}$",
"description": "Subdomain used for the custom MAIL FROM (bounce handling and SPF)."
}
}
},
"annotations": {
"title": "Create a domain",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Retrieve a domain. Requires a `full_access` API key. API: `GET /domains/{id}` (operationId `getDomain`, Domains).
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "get_domain",
"title": "Retrieve a domain",
"description": "Retrieve a domain.\n\nRequires a `full_access` API key. API: `GET /domains/{id}` (operationId `getDomain`, Domains).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
}
},
"annotations": {
"title": "Retrieve a domain",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Update a domain. Toggles open and click tracking. Requires a `full_access` API key. API: `PATCH /domains/{id}` (operationId `updateDomain`, Domains).
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| tls | string | one of ["opportunistic","enforced"] |
| open_tracking | boolean | |
| click_tracking | boolean |
{
"name": "update_domain",
"title": "Update a domain",
"description": "Update a domain.\n\nToggles open and click tracking.\n\nRequires a `full_access` API key. API: `PATCH /domains/{id}` (operationId `updateDomain`, Domains).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"tls": {
"enum": [
"opportunistic",
"enforced"
],
"type": "string"
},
"open_tracking": {
"type": "boolean"
},
"click_tracking": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Update a domain",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Delete a domain. Requires a `full_access` API key. API: `DELETE /domains/{id}` (operationId `deleteDomain`, Domains).
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "delete_domain",
"title": "Delete a domain",
"description": "Delete a domain.\n\nRequires a `full_access` API key. API: `DELETE /domains/{id}` (operationId `deleteDomain`, Domains).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
}
},
"annotations": {
"title": "Delete a domain",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Verify a domain. Re-checks DNS now. Retrieve the domain afterwards to read the new `status` and per-record statuses. Requires a `full_access` API key. API: `POST /domains/{id}/verify` (operationId `verifyDomain`, Domains).
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "verify_domain",
"title": "Verify a domain",
"description": "Verify a domain.\n\nRe-checks DNS now. Retrieve the domain afterwards to read the new `status` and per-record statuses.\n\nRequires a `full_access` API key. API: `POST /domains/{id}/verify` (operationId `verifyDomain`, Domains).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
}
},
"annotations": {
"title": "Verify a domain",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List API keys. Requires a `full_access` API key. API: `GET /api-keys` (operationId `listApiKeys`, API Keys).
| Parameter | Type | Description |
|---|---|---|
| after | string | Return items older than this id (next page). Cannot be combined with `before`. |
| limit | integer | Number of items to return. |
| before | string | Return items newer than this id (previous page). Cannot be combined with `after`. |
{
"name": "list_api_keys",
"title": "List API keys",
"description": "List API keys.\n\nRequires a `full_access` API key. API: `GET /api-keys` (operationId `listApiKeys`, API Keys).",
"inputSchema": {
"type": "object",
"properties": {
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of items to return."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
},
"annotations": {
"title": "List API keys",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create an API key. The `token` is returned only in this response. Requires a `full_access` API key. API: `POST /api-keys` (operationId `createApiKey`, API Keys).
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| domain_id | string | Restrict a `sending_access` key to one of your domains. Not allowed with `full_access`. |
| permission | string | one of ["full_access","sending_access"] |
{
"name": "create_api_key",
"title": "Create an API key",
"description": "Create an API key.\n\nThe `token` is returned only in this response.\n\nRequires a `full_access` API key. API: `POST /api-keys` (operationId `createApiKey`, API Keys).",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 50,
"minLength": 1
},
"domain_id": {
"type": "string",
"format": "uuid",
"description": "Restrict a `sending_access` key to one of your domains. Not allowed with `full_access`."
},
"permission": {
"enum": [
"full_access",
"sending_access"
],
"type": "string",
"default": "full_access"
}
}
},
"annotations": {
"title": "Create an API key",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Delete an API key. The key stops working immediately. The response body is an empty object. Requires a `full_access` API key. API: `DELETE /api-keys/{id}` (operationId `deleteApiKey`, API Keys).
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "delete_api_key",
"title": "Delete an API key",
"description": "Delete an API key.\n\nThe key stops working immediately. The response body is an empty object.\n\nRequires a `full_access` API key. API: `DELETE /api-keys/{id}` (operationId `deleteApiKey`, API Keys).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
}
},
"annotations": {
"title": "Delete an API key",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}List webhooks. Requires a `full_access` API key. API: `GET /webhooks` (operationId `listWebhooks`, Webhooks).
| Parameter | Type | Description |
|---|---|---|
| after | string | Return items older than this id (next page). Cannot be combined with `before`. |
| limit | integer | Number of items to return. |
| before | string | Return items newer than this id (previous page). Cannot be combined with `after`. |
{
"name": "list_webhooks",
"title": "List webhooks",
"description": "List webhooks.\n\nRequires a `full_access` API key. API: `GET /webhooks` (operationId `listWebhooks`, Webhooks).",
"inputSchema": {
"type": "object",
"properties": {
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of items to return."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
},
"annotations": {
"title": "List webhooks",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a webhook. In production the endpoint must use https and resolve to a public address. Requires a `full_access` API key. API: `POST /webhooks` (operationId `createWebhook`, Webhooks).
| Parameter | Type | Description |
|---|---|---|
| events * | array | |
| endpoint * | string | Public URL that receives POST requests. https is required in production. |
{
"name": "create_webhook",
"title": "Create a webhook",
"description": "Create a webhook.\n\nIn production the endpoint must use https and resolve to a public address.\n\nRequires a `full_access` API key. API: `POST /webhooks` (operationId `createWebhook`, Webhooks).",
"inputSchema": {
"type": "object",
"required": [
"endpoint",
"events"
],
"properties": {
"events": {
"type": "array",
"items": {
"enum": [
"email.sent",
"email.delivered",
"email.delivery_delayed",
"email.bounced",
"email.complained",
"email.opened",
"email.clicked",
"email.failed",
"email.scheduled",
"email.suppressed"
],
"type": "string",
"description": "Event names you can subscribe a webhook to."
},
"minItems": 1
},
"endpoint": {
"type": "string",
"format": "uri",
"description": "Public URL that receives POST requests. https is required in production."
}
}
},
"annotations": {
"title": "Create a webhook",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Retrieve a webhook. Requires a `full_access` API key. API: `GET /webhooks/{id}` (operationId `getWebhook`, Webhooks).
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "get_webhook",
"title": "Retrieve a webhook",
"description": "Retrieve a webhook.\n\nRequires a `full_access` API key. API: `GET /webhooks/{id}` (operationId `getWebhook`, Webhooks).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
}
},
"annotations": {
"title": "Retrieve a webhook",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Update a webhook. Requires a `full_access` API key. API: `PATCH /webhooks/{id}` (operationId `updateWebhook`, Webhooks).
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| events | array | |
| status | string | one of ["enabled","disabled"] |
| endpoint | string |
{
"name": "update_webhook",
"title": "Update a webhook",
"description": "Update a webhook.\n\nRequires a `full_access` API key. API: `PATCH /webhooks/{id}` (operationId `updateWebhook`, Webhooks).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"events": {
"type": "array",
"items": {
"enum": [
"email.sent",
"email.delivered",
"email.delivery_delayed",
"email.bounced",
"email.complained",
"email.opened",
"email.clicked",
"email.failed",
"email.scheduled",
"email.suppressed"
],
"type": "string",
"description": "Event names you can subscribe a webhook to."
},
"minItems": 1
},
"status": {
"enum": [
"enabled",
"disabled"
],
"type": "string"
},
"endpoint": {
"type": "string",
"format": "uri"
}
}
},
"annotations": {
"title": "Update a webhook",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Delete a webhook. Requires a `full_access` API key. API: `DELETE /webhooks/{id}` (operationId `deleteWebhook`, Webhooks).
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "delete_webhook",
"title": "Delete a webhook",
"description": "Delete a webhook.\n\nRequires a `full_access` API key. API: `DELETE /webhooks/{id}` (operationId `deleteWebhook`, Webhooks).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
}
},
"annotations": {
"title": "Delete a webhook",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}List audiences. Requires a `full_access` API key. API: `GET /audiences` (operationId `listAudiences`, Audiences).
| Parameter | Type | Description |
|---|---|---|
| after | string | Return items older than this id (next page). Cannot be combined with `before`. |
| limit | integer | Number of items to return. |
| before | string | Return items newer than this id (previous page). Cannot be combined with `after`. |
{
"name": "list_audiences",
"title": "List audiences",
"description": "List audiences.\n\nRequires a `full_access` API key. API: `GET /audiences` (operationId `listAudiences`, Audiences).",
"inputSchema": {
"type": "object",
"properties": {
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of items to return."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
},
"annotations": {
"title": "List audiences",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create an audience. Requires a `full_access` API key. API: `POST /audiences` (operationId `createAudience`, Audiences).
| Parameter | Type | Description |
|---|---|---|
| name * | string |
{
"name": "create_audience",
"title": "Create an audience",
"description": "Create an audience.\n\nRequires a `full_access` API key. API: `POST /audiences` (operationId `createAudience`, Audiences).",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
}
},
"annotations": {
"title": "Create an audience",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Retrieve an audience. Requires a `full_access` API key. API: `GET /audiences/{id}` (operationId `getAudience`, Audiences).
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "get_audience",
"title": "Retrieve an audience",
"description": "Retrieve an audience.\n\nRequires a `full_access` API key. API: `GET /audiences/{id}` (operationId `getAudience`, Audiences).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
}
},
"annotations": {
"title": "Retrieve an audience",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Delete an audience. Also deletes its contacts. Requires a `full_access` API key. API: `DELETE /audiences/{id}` (operationId `deleteAudience`, Audiences).
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "delete_audience",
"title": "Delete an audience",
"description": "Delete an audience.\n\nAlso deletes its contacts.\n\nRequires a `full_access` API key. API: `DELETE /audiences/{id}` (operationId `deleteAudience`, Audiences).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
}
},
"annotations": {
"title": "Delete an audience",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}List contacts. Requires a `full_access` API key. API: `GET /audiences/{audienceId}/contacts` (operationId `listContacts`, Contacts).
| Parameter | Type | Description |
|---|---|---|
| after | string | Return items older than this id (next page). Cannot be combined with `before`. |
| limit | integer | Number of items to return. |
| before | string | Return items newer than this id (previous page). Cannot be combined with `after`. |
| audience_id * | string |
{
"name": "list_contacts",
"title": "List contacts",
"description": "List contacts.\n\nRequires a `full_access` API key. API: `GET /audiences/{audienceId}/contacts` (operationId `listContacts`, Contacts).",
"inputSchema": {
"type": "object",
"required": [
"audience_id"
],
"properties": {
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of items to return."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
},
"audience_id": {
"type": "string",
"format": "uuid"
}
}
},
"annotations": {
"title": "List contacts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a contact. Emails are lower-cased. An address can only appear once per audience. Requires a `full_access` API key. API: `POST /audiences/{audienceId}/contacts` (operationId `createContact`, Contacts).
| Parameter | Type | Description |
|---|---|---|
| email * | string | |
| last_name | string | |
| first_name | string | |
| audience_id * | string | |
| unsubscribed | boolean |
{
"name": "create_contact",
"title": "Create a contact",
"description": "Create a contact.\n\nEmails are lower-cased. An address can only appear once per audience.\n\nRequires a `full_access` API key. API: `POST /audiences/{audienceId}/contacts` (operationId `createContact`, Contacts).",
"inputSchema": {
"type": "object",
"required": [
"audience_id",
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email"
},
"last_name": {
"type": "string",
"maxLength": 100
},
"first_name": {
"type": "string",
"maxLength": 100
},
"audience_id": {
"type": "string",
"format": "uuid"
},
"unsubscribed": {
"type": "boolean",
"default": false
}
}
},
"annotations": {
"title": "Create a contact",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Retrieve a contact. Requires a `full_access` API key. API: `GET /audiences/{audienceId}/contacts/{idOrEmail}` (operationId `getContact`, Contacts).
| Parameter | Type | Description |
|---|---|---|
| audience_id * | string | |
| id_or_email * | string | The contact id or its (URL-encoded) email address. |
{
"name": "get_contact",
"title": "Retrieve a contact",
"description": "Retrieve a contact.\n\nRequires a `full_access` API key. API: `GET /audiences/{audienceId}/contacts/{idOrEmail}` (operationId `getContact`, Contacts).",
"inputSchema": {
"type": "object",
"required": [
"audience_id",
"id_or_email"
],
"properties": {
"audience_id": {
"type": "string",
"format": "uuid"
},
"id_or_email": {
"type": "string",
"examples": [
"jane@example.com"
],
"description": "The contact id or its (URL-encoded) email address."
}
}
},
"annotations": {
"title": "Retrieve a contact",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Update a contact. Requires a `full_access` API key. API: `PATCH /audiences/{audienceId}/contacts/{idOrEmail}` (operationId `updateContact`, Contacts).
| Parameter | Type | Description |
|---|---|---|
| last_name | string | |
| first_name | string | |
| audience_id * | string | |
| id_or_email * | string | The contact id or its (URL-encoded) email address. |
| unsubscribed | boolean |
{
"name": "update_contact",
"title": "Update a contact",
"description": "Update a contact.\n\nRequires a `full_access` API key. API: `PATCH /audiences/{audienceId}/contacts/{idOrEmail}` (operationId `updateContact`, Contacts).",
"inputSchema": {
"type": "object",
"required": [
"audience_id",
"id_or_email"
],
"properties": {
"last_name": {
"type": "string",
"maxLength": 100
},
"first_name": {
"type": "string",
"maxLength": 100
},
"audience_id": {
"type": "string",
"format": "uuid"
},
"id_or_email": {
"type": "string",
"examples": [
"jane@example.com"
],
"description": "The contact id or its (URL-encoded) email address."
},
"unsubscribed": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Update a contact",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Delete a contact. Requires a `full_access` API key. API: `DELETE /audiences/{audienceId}/contacts/{idOrEmail}` (operationId `deleteContact`, Contacts).
| Parameter | Type | Description |
|---|---|---|
| audience_id * | string | |
| id_or_email * | string | The contact id or its (URL-encoded) email address. |
{
"name": "delete_contact",
"title": "Delete a contact",
"description": "Delete a contact.\n\nRequires a `full_access` API key. API: `DELETE /audiences/{audienceId}/contacts/{idOrEmail}` (operationId `deleteContact`, Contacts).",
"inputSchema": {
"type": "object",
"required": [
"audience_id",
"id_or_email"
],
"properties": {
"audience_id": {
"type": "string",
"format": "uuid"
},
"id_or_email": {
"type": "string",
"examples": [
"jane@example.com"
],
"description": "The contact id or its (URL-encoded) email address."
}
}
},
"annotations": {
"title": "Delete a contact",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}List broadcasts. Requires a `full_access` API key. API: `GET /broadcasts` (operationId `listBroadcasts`, Broadcasts).
| Parameter | Type | Description |
|---|---|---|
| after | string | Return items older than this id (next page). Cannot be combined with `before`. |
| limit | integer | Number of items to return. |
| before | string | Return items newer than this id (previous page). Cannot be combined with `after`. |
{
"name": "list_broadcasts",
"title": "List broadcasts",
"description": "List broadcasts.\n\nRequires a `full_access` API key. API: `GET /broadcasts` (operationId `listBroadcasts`, Broadcasts).",
"inputSchema": {
"type": "object",
"properties": {
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of items to return."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
},
"annotations": {
"title": "List broadcasts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a broadcast. Creates a draft. The `from` address must belong to a verified domain of your team and `audience_id` to one of your audiences. Requires a `full_access` API key. API: `POST /broadcasts` (operationId `createBroadcast`, Broadcasts).
| Parameter | Type | Description |
|---|---|---|
| from * | string | An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains. |
| html | string | |
| name | string | Internal name |
| text | string | |
| subject * | string | |
| reply_to | any | |
| audience_id * | string | |
| preview_text | string |
{
"name": "create_broadcast",
"title": "Create a broadcast",
"description": "Create a broadcast.\n\nCreates a draft. The `from` address must belong to a verified domain of your team and `audience_id` to one of your audiences.\n\nRequires a `full_access` API key. API: `POST /broadcasts` (operationId `createBroadcast`, Broadcasts).",
"inputSchema": {
"type": "object",
"required": [
"audience_id",
"from",
"subject"
],
"properties": {
"from": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"html": {
"type": "string"
},
"name": {
"type": "string",
"maxLength": 100,
"description": "Internal name",
"not shown to recipients.": null
},
"text": {
"type": "string"
},
"subject": {
"type": "string",
"maxLength": 998,
"minLength": 1
},
"reply_to": {
"oneOf": [
{
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
{
"type": "array",
"items": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"maxItems": 50,
"minItems": 1
}
]
},
"audience_id": {
"type": "string",
"format": "uuid"
},
"preview_text": {
"type": "string",
"maxLength": 200
}
}
},
"annotations": {
"title": "Create a broadcast",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Retrieve a broadcast. Requires a `full_access` API key. API: `GET /broadcasts/{id}` (operationId `getBroadcast`, Broadcasts).
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "get_broadcast",
"title": "Retrieve a broadcast",
"description": "Retrieve a broadcast.\n\nRequires a `full_access` API key. API: `GET /broadcasts/{id}` (operationId `getBroadcast`, Broadcasts).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
}
},
"annotations": {
"title": "Retrieve a broadcast",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Update a broadcast. Only drafts can be updated. Request body: Any field of the create request; only drafts can be updated. Requires a `full_access` API key. API: `PATCH /broadcasts/{id}` (operationId `updateBroadcast`, Broadcasts).
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| from | string | An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains. |
| html | string | |
| name | string | |
| text | string | |
| subject | string | |
| reply_to | any | |
| audience_id | string | |
| preview_text | string |
{
"name": "update_broadcast",
"title": "Update a broadcast",
"description": "Update a broadcast.\n\nOnly drafts can be updated.\n\nRequest body: Any field of the create request; only drafts can be updated.\n\nRequires a `full_access` API key. API: `PATCH /broadcasts/{id}` (operationId `updateBroadcast`, Broadcasts).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"from": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"html": {
"type": "string"
},
"name": {
"type": "string",
"maxLength": 100
},
"text": {
"type": "string"
},
"subject": {
"type": "string",
"maxLength": 998,
"minLength": 1
},
"reply_to": {
"oneOf": [
{
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
{
"type": "array",
"items": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"maxItems": 50,
"minItems": 1
}
]
},
"audience_id": {
"type": "string",
"format": "uuid"
},
"preview_text": {
"type": "string",
"maxLength": 200
}
}
},
"annotations": {
"title": "Update a broadcast",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Delete a broadcast. Only drafts and broadcasts that are scheduled for the future can be deleted. Requires a `full_access` API key. API: `DELETE /broadcasts/{id}` (operationId `deleteBroadcast`, Broadcasts).
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "delete_broadcast",
"title": "Delete a broadcast",
"description": "Delete a broadcast.\n\nOnly drafts and broadcasts that are scheduled for the future can be deleted.\n\nRequires a `full_access` API key. API: `DELETE /broadcasts/{id}` (operationId `deleteBroadcast`, Broadcasts).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
}
},
"annotations": {
"title": "Delete a broadcast",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Check a broadcast before sending. SpacePost extension (not part of Resend). Returns a deliverability checklist: sender domain and DMARC, subject, Gmail clipping (HTML over 102 KB), image-heavy bodies, link shorteners, spam phrases, unsubscribe link and audience quality. `ready` is false when any check has level `error`; `POST /broadcasts/{id}/send` is then refused with `validation_error`. Warnings never block a send. Requires a `full_access` API key. API: `GET /broadcasts/{id}/readiness` (operationId `getBroadcastReadiness`, Broadcasts).
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "get_broadcast_readiness",
"title": "Check a broadcast before sending",
"description": "Check a broadcast before sending.\n\nSpacePost extension (not part of Resend). Returns a deliverability checklist: sender domain and DMARC, subject, Gmail\nclipping (HTML over 102 KB), image-heavy bodies, link shorteners, spam phrases, unsubscribe link and audience quality.\n`ready` is false when any check has level `error`; `POST /broadcasts/{id}/send` is then refused with `validation_error`.\nWarnings never block a send.\n\nRequires a `full_access` API key. API: `GET /broadcasts/{id}/readiness` (operationId `getBroadcastReadiness`, Broadcasts).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
}
},
"annotations": {
"title": "Check a broadcast before sending",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Send or schedule a broadcast. Queues a draft for delivery to every subscribed contact of its audience. The broadcast needs `html` or `text`. Without `scheduled_at` it starts immediately; the status becomes `queued`, then `sending` and `sent`. Sends to every subscribed contact in the audience. Run get_broadcast_readiness first and confirm with the user. Requires a `full_access` API key. API: `POST /broadcasts/{id}/send` (operationId `sendBroadcast`, Broadcasts).
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| scheduled_at | string | ISO 8601 date-time or natural language such as "in 1 hour" or "in 2 days". At most 30 days ahead. |
{
"name": "send_broadcast",
"title": "Send or schedule a broadcast",
"description": "Send or schedule a broadcast.\n\nQueues a draft for delivery to every subscribed contact of its audience. The broadcast needs `html` or `text`.\nWithout `scheduled_at` it starts immediately; the status becomes `queued`, then `sending` and `sent`.\n\nSends to every subscribed contact in the audience. Run get_broadcast_readiness first and confirm with the user.\n\nRequires a `full_access` API key. API: `POST /broadcasts/{id}/send` (operationId `sendBroadcast`, Broadcasts).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"scheduled_at": {
"type": "string",
"examples": [
"in 1 hour",
"2026-10-30T09:00:00Z"
],
"description": "ISO 8601 date-time or natural language such as \"in 1 hour\" or \"in 2 days\". At most 30 days ahead."
}
}
},
"annotations": {
"title": "Send or schedule a broadcast",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}List suppressions. Requires a `full_access` API key. API: `GET /suppressions` (operationId `listSuppressions`, Suppressions).
| Parameter | Type | Description |
|---|---|---|
| after | string | Return items older than this id (next page). Cannot be combined with `before`. |
| limit | integer | Number of items to return. |
| before | string | Return items newer than this id (previous page). Cannot be combined with `after`. |
{
"name": "list_suppressions",
"title": "List suppressions",
"description": "List suppressions.\n\nRequires a `full_access` API key. API: `GET /suppressions` (operationId `listSuppressions`, Suppressions).",
"inputSchema": {
"type": "object",
"properties": {
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of items to return."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
},
"annotations": {
"title": "List suppressions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Add a suppression. Adds the address with reason `manual`. Adding an address that is already suppressed returns the existing entry. Requires a `full_access` API key. API: `POST /suppressions` (operationId `createSuppression`, Suppressions).
| Parameter | Type | Description |
|---|---|---|
| email * | string |
{
"name": "create_suppression",
"title": "Add a suppression",
"description": "Add a suppression.\n\nAdds the address with reason `manual`. Adding an address that is already suppressed returns the existing entry.\n\nRequires a `full_access` API key. API: `POST /suppressions` (operationId `createSuppression`, Suppressions).",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email"
}
}
},
"annotations": {
"title": "Add a suppression",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Remove a suppression. Requires a `full_access` API key. API: `DELETE /suppressions/{idOrEmail}` (operationId `deleteSuppression`, Suppressions).
| Parameter | Type | Description |
|---|---|---|
| id_or_email * | string | The suppression id or the (URL-encoded) email address. |
{
"name": "delete_suppression",
"title": "Remove a suppression",
"description": "Remove a suppression.\n\nRequires a `full_access` API key. API: `DELETE /suppressions/{idOrEmail}` (operationId `deleteSuppression`, Suppressions).",
"inputSchema": {
"type": "object",
"required": [
"id_or_email"
],
"properties": {
"id_or_email": {
"type": "string",
"examples": [
"bounced@example.com"
],
"description": "The suppression id or the (URL-encoded) email address."
}
}
},
"annotations": {
"title": "Remove a suppression",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}List tenants. Requires a `full_access` API key. API: `GET /tenants` (operationId `listTenants`, Tenants).
| Parameter | Type | Description |
|---|---|---|
| after | string | Return items older than this id (next page). Cannot be combined with `before`. |
| limit | integer | Number of items to return. |
| before | string | Return items newer than this id (previous page). Cannot be combined with `after`. |
{
"name": "list_tenants",
"title": "List tenants",
"description": "List tenants.\n\nRequires a `full_access` API key. API: `GET /tenants` (operationId `listTenants`, Tenants).",
"inputSchema": {
"type": "object",
"properties": {
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of items to return."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
},
"annotations": {
"title": "List tenants",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a tenant. Creates one of your customers, with its own SES tenant (isolated reputation). `external_id` must be unique within your account. Requires a `full_access` API key. API: `POST /tenants` (operationId `createTenant`, Tenants).
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| trust_mark | string | SpacePost's own (internal) accounts only; other accounts get 403. `trusted` vouches that this customer pays and is established in your product, and the tenant then skips the outside abuse-screening services once it also meets SpacePost's trust rules on its own sending. `system` marks your product's … |
| daily_limit | ["integer","null"] | Max recipients per day for this tenant. Omit or null for no cap. |
| external_id | string | Your own id for the customer. Unique per account; accepted wherever a tenant id is. |
{
"name": "create_tenant",
"title": "Create a tenant",
"description": "Create a tenant.\n\nCreates one of your customers, with its own SES tenant (isolated reputation). `external_id` must be unique within your account.\n\nRequires a `full_access` API key. API: `POST /tenants` (operationId `createTenant`, Tenants).",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"trust_mark": {
"enum": [
"none",
"trusted",
"system"
],
"type": "string",
"description": "SpacePost's own (internal) accounts only; other accounts get 403. `trusted` vouches that this customer pays and is established in your product, and the tenant then skips the outside abuse-screening services once it also meets SpacePost's trust rules on its own sending. `system` marks your product's own system mail. `none` (default) means full screening."
},
"daily_limit": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "Max recipients per day for this tenant. Omit or null for no cap."
},
"external_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Your own id for the customer. Unique per account; accepted wherever a tenant id is."
}
}
},
"annotations": {
"title": "Create a tenant",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Retrieve a tenant. Requires a `full_access` API key. API: `GET /tenants/{ref}` (operationId `getTenant`, Tenants).
| Parameter | Type | Description |
|---|---|---|
| ref * | string | The tenant id or your own `external_id`. |
{
"name": "get_tenant",
"title": "Retrieve a tenant",
"description": "Retrieve a tenant.\n\nRequires a `full_access` API key. API: `GET /tenants/{ref}` (operationId `getTenant`, Tenants).",
"inputSchema": {
"type": "object",
"required": [
"ref"
],
"properties": {
"ref": {
"type": "string",
"examples": [
"cust_123"
],
"maxLength": 200,
"minLength": 1,
"description": "The tenant id or your own `external_id`."
}
}
},
"annotations": {
"title": "Retrieve a tenant",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Update a tenant. Changes the name, `external_id` or `daily_limit` (`null` removes the cap). Requires a `full_access` API key. API: `PATCH /tenants/{ref}` (operationId `updateTenant`, Tenants).
| Parameter | Type | Description |
|---|---|---|
| ref * | string | The tenant id or your own `external_id`. |
| name | string | |
| trust_mark | string | SpacePost's own (internal) accounts only; other accounts get 403. `trusted` vouches that this customer pays and is established in your product, and the tenant then skips the outside abuse-screening services once it also meets SpacePost's trust rules on its own sending. `system` marks your product's … |
| daily_limit | ["integer","null"] | Null removes the cap. |
| external_id | string |
{
"name": "update_tenant",
"title": "Update a tenant",
"description": "Update a tenant.\n\nChanges the name, `external_id` or `daily_limit` (`null` removes the cap).\n\nRequires a `full_access` API key. API: `PATCH /tenants/{ref}` (operationId `updateTenant`, Tenants).",
"inputSchema": {
"type": "object",
"required": [
"ref"
],
"properties": {
"ref": {
"type": "string",
"examples": [
"cust_123"
],
"maxLength": 200,
"minLength": 1,
"description": "The tenant id or your own `external_id`."
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"trust_mark": {
"enum": [
"none",
"trusted",
"system"
],
"type": "string",
"description": "SpacePost's own (internal) accounts only; other accounts get 403. `trusted` vouches that this customer pays and is established in your product, and the tenant then skips the outside abuse-screening services once it also meets SpacePost's trust rules on its own sending. `system` marks your product's own system mail. `none` (default) means full screening."
},
"daily_limit": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "Null removes the cap."
},
"external_id": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
}
},
"annotations": {
"title": "Update a tenant",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Delete a tenant. Fails with `422` while the tenant still has domains; delete those first. Requires a `full_access` API key. API: `DELETE /tenants/{ref}` (operationId `deleteTenant`, Tenants).
| Parameter | Type | Description |
|---|---|---|
| ref * | string | The tenant id or your own `external_id`. |
{
"name": "delete_tenant",
"title": "Delete a tenant",
"description": "Delete a tenant.\n\nFails with `422` while the tenant still has domains; delete those first.\n\nRequires a `full_access` API key. API: `DELETE /tenants/{ref}` (operationId `deleteTenant`, Tenants).",
"inputSchema": {
"type": "object",
"required": [
"ref"
],
"properties": {
"ref": {
"type": "string",
"examples": [
"cust_123"
],
"maxLength": 200,
"minLength": 1,
"description": "The tenant id or your own `external_id`."
}
}
},
"annotations": {
"title": "Delete a tenant",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Pause a tenant. Stops all sending for the tenant. Sends return `403 sending_paused`; emails already queued fail. The body is optional. Requires a `full_access` API key. API: `POST /tenants/{ref}/pause` (operationId `pauseTenant`, Tenants).
| Parameter | Type | Description |
|---|---|---|
| ref * | string | The tenant id or your own `external_id`. |
| reason | string | Stored as `paused_reason`. Defaults to a generic reason. |
{
"name": "pause_tenant",
"title": "Pause a tenant",
"description": "Pause a tenant.\n\nStops all sending for the tenant. Sends return `403 sending_paused`; emails already queued fail. The body is optional.\n\nRequires a `full_access` API key. API: `POST /tenants/{ref}/pause` (operationId `pauseTenant`, Tenants).",
"inputSchema": {
"type": "object",
"required": [
"ref"
],
"properties": {
"ref": {
"type": "string",
"examples": [
"cust_123"
],
"maxLength": 200,
"minLength": 1,
"description": "The tenant id or your own `external_id`."
},
"reason": {
"type": "string",
"maxLength": 300,
"description": "Stored as `paused_reason`. Defaults to a generic reason."
}
}
},
"annotations": {
"title": "Pause a tenant",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Unpause a tenant. Resumes sending. A tenant that was paused by the reputation guard (bounce or complaint rate) can only be unpaused by a `trusted` or `internal` team; others get `403 invalid_access` and should contact support. Requires a `full_access` API key. API: `POST /tenants/{ref}/unpause` (operationId `unpauseTenant`, Tenants).
| Parameter | Type | Description |
|---|---|---|
| ref * | string | The tenant id or your own `external_id`. |
{
"name": "unpause_tenant",
"title": "Unpause a tenant",
"description": "Unpause a tenant.\n\nResumes sending. A tenant that was paused by the reputation guard (bounce or complaint rate) can only be unpaused by a\n`trusted` or `internal` team; others get `403 invalid_access` and should contact support.\n\nRequires a `full_access` API key. API: `POST /tenants/{ref}/unpause` (operationId `unpauseTenant`, Tenants).",
"inputSchema": {
"type": "object",
"required": [
"ref"
],
"properties": {
"ref": {
"type": "string",
"examples": [
"cust_123"
],
"maxLength": 200,
"minLength": 1,
"description": "The tenant id or your own `external_id`."
}
}
},
"annotations": {
"title": "Unpause a tenant",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}SpacePost is a Resend-compatible email API. Every tool maps to one REST endpoint and returns its JSON response. To send: list_domains to find a verified domain for `from`, then send_email. List tools paginate with `limit` and `after` (the id of the last item). Errors come back as { statusCode, name, message }.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| array |
| text | string |
| headers | object |
| subject * | string |
| reply_to | any |
| tracking | object | SpacePost extension. Overrides the sending domain's open/click tracking for this email only; an omitted key falls back to the domain setting (`PATCH /domains/{id}`). Lets a platform opt individual customers into open tracking on a shared domain. |
| tenant_id | string | Platform mode. Our tenant id or your `external_id`. Optional when the `from` domain belongs to a tenant; a conflict with the domain's tenant is a 422. |
| attachments | array |
| scheduled_at | string | ISO 8601 date-time or natural language such as "in 1 hour" or "in 2 days". At most 30 days ahead. |
| idempotency_key | string | A unique key (1 to 256 characters) that makes the request safe to retry for 24 hours. |
{
"name": "send_email",
"title": "Send an email",
"description": "Send an email.\n\nValidates and queues one email. Each recipient counts towards your quota. Use `scheduled_at` to send later (up to 30 days ahead). Pass `tenant_id` to send on behalf of a tenant (not needed when the `from` domain belongs to one). Fails with `422` if `tenant_id` conflicts with the domain's tenant, `403 sending_paused` if the tenant is paused and `429 daily_quota_exceeded` if it reached its daily cap. Pass `tracking` (`{ open?, click? }`) to override the domain's open/click tracking for this email only; an omitted key keeps the domain setting.\n\n`from` must be on a verified domain (e.g. \"Acme <hi@acme.com>\"); call list_domains to find one. Provide `html`, `text` or both. Send to delivered@test.spacepost.dev (or bounced@ / complained@) to test without sending real mail. Delivered email cannot be recalled: confirm recipients and content with the user when unsure. Pass `idempotency_key` when retrying so the email is not sent twice.\n\nRequest body: Either `html` or `text` is required. `reply_to` is also accepted as `replyTo` and `scheduled_at` as `scheduledAt`.\n\nWorks with a `sending_access` or `full_access` API key. API: `POST /emails` (operationId `sendEmail`, Emails).",
"inputSchema": {
"type": "object",
"required": [
"from",
"to",
"subject"
],
"properties": {
"cc": {
"oneOf": [
{
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
{
"type": "array",
"items": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"maxItems": 50,
"minItems": 1
}
]
},
"to": {
"oneOf": [
{
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
{
"type": "array",
"items": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"maxItems": 50,
"minItems": 1
}
]
},
"bcc": {
"oneOf": [
{
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
{
"type": "array",
"items": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"maxItems": 50,
"minItems": 1
}
]
},
"from": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"html": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 256
},
"value": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 256
}
}
},
"maxItems": 50
},
"text": {
"type": "string"
},
"headers": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"subject": {
"type": "string",
"maxLength": 998,
"minLength": 1
},
"reply_to": {
"oneOf": [
{
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
{
"type": "array",
"items": {
"type": "string",
"examples": [
"Acme <hello@acme.com>"
],
"maxLength": 998,
"description": "An email address, optionally with a display name: `Acme <hello@acme.com>`. At most 998 characters, display name included. A display name can't contain `<`, `>` or an encoded word, and a `from` name can only show an email address on one of your verified domains."
},
"maxItems": 50,
"minItems": 1
}
]
},
"tracking": {
"type": "object",
"properties": {
"open": {
"type": "boolean",
"description": "Track opens (adds a tracking pixel and `email.opened` events)."
},
"click": {
"type": "boolean",
"description": "Track link clicks (rewrites links and adds `email.clicked` events)."
}
},
"description": "SpacePost extension. Overrides the sending domain's open/click tracking for this email only; an omitted key falls back to the domain setting (`PATCH /domains/{id}`). Lets a platform opt individual customers into open tracking on a shared domain.",
"additionalProperties": false
},
"tenant_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Platform mode. Our tenant id or your `external_id`. Optional when the `from` domain belongs to a tenant; a conflict with the domain's tenant is a 422."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"required": [
"filename"
],
"properties": {
"path": {
"type": "string",
"format": "uri",
"description": "A public URL fetched at send time."
},
"content": {
"type": "string",
"description": "Base64-encoded file content."
},
"filename": {
"type": "string",
"maxLength": 255
},
"content_id": {
"type": "string",
"description": "Content-ID for inline images (`cid:`)."
},
"content_type": {
"type": "string",
"examples": [
"application/pdf"
]
}
},
"description": "Provide exactly one of `content` or `path`."
},
"maxItems": 50
},
"scheduled_at": {
"type": "string",
"examples": [
"in 1 hour",
"2026-10-30T09:00:00Z"
],
"description": "ISO 8601 date-time or natural language such as \"in 1 hour\" or \"in 2 days\". At most 30 days ahead."
},
"idempotency_key": {
"type": "string",
"examples": [
"welcome-user-4821"
],
"maxLength": 256,
"minLength": 1,
"description": "A unique key (1 to 256 characters) that makes the request safe to retry for 24 hours."
}
}
},
"annotations": {
"title": "Send an email",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}