SpacePost
Send email and manage domains, contacts and webhooks on SpacePost, the Resend-compatible email API.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (5)
- LOWTool 'list_webhooks' suggests web access but openWorldHint=falseen list_webhooks
- LOWTool 'create_webhook' suggests web access but openWorldHint=falseen create_webhook
- LOWTool 'get_webhook' suggests web access but openWorldHint=falseen get_webhook
- LOWTool 'update_webhook' suggests web access but openWorldHint=falseen update_webhook
- LOWTool 'delete_webhook' suggests web access but openWorldHint=falseen delete_webhook
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"@spacepost/mcp"
]
}
}
}Paquetes ejecutables
0.2.1stdioPuntos de conexión remotos
https://api.spacepost.dev/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (46)
🟢list_emails(limit, after, before)
List emails. Returns sent and scheduled emails, newest first, without bodies. Requires a `full_access` API key. API: `GET /emails` (operationId `listEmails`, Emails).
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Number of items to return."
},
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
}🟡send_email(idempotency_key, from, to, subject, cc, ...)
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. `from` must be on a verified domain (e.g. "Acme <[email protected]>"); call list_domains to find one. Provide `html`, `text` or both. Send to [email protected] (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).
Esquema de entrada
{
"type": "object",
"properties": {
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"description": "A unique key (1 to 256 characters) that makes the request safe to retry for 24 hours.",
"examples": [
"welcome-user-4821"
]
},
"from": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
"to": {
"oneOf": [
{
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
{
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
}
}
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 998
},
"cc": {
"oneOf": [
{
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
{
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
}
}
]
},
"bcc": {
"oneOf": [
{
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
{
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
}
}
]
},
"reply_to": {
"oneOf": [
{
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
{
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
}
}
]
},
"html": {
"type": "string"
},
"text": {
"type": "string"
},
"headers": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"attachments": {
"type": "array",
"maxItems": 50,
"items": {
"type": "object",
"required": [
"filename"
],
"description": "Provide exactly one of `content` or `path`.",
"properties": {
"filename": {
"type": "string",
"maxLength": 255
},
"content": {
"type": "string",
"description": "Base64-encoded file content."
},
"path": {
"type": "string",
"format": "uri",
"description": "A public URL fetched at send time."
},
"content_type": {
"type": "string",
"examples": [
"application/pdf"
]
},
"content_id": {
"type": "string",
"description": "Content-ID for inline images (`cid:`)."
}
}
}
},
"tags": {
"type": "array",
"maxItems": 50,
"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
}
}
}
},
"scheduled_at": {
"type": "string",
"description": "ISO 8601 date-time or natural language such as \"in 1 hour\" or \"in 2 days\". At most 30 days ahead.",
"examples": [
"in 1 hour",
"2026-10-30T09:00:00Z"
]
},
"tenant_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"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."
}
},
"required": [
"from",
"to",
"subject"
]
}🟡send_batch_emails(idempotency_key, body)
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` 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).
Esquema de entrada
{
"type": "object",
"properties": {
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"description": "A unique key (1 to 256 characters) that makes the request safe to retry for 24 hours.",
"examples": [
"welcome-user-4821"
]
},
"body": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"type": "object",
"description": "Either `html` or `text` is required. `reply_to` is also accepted as `replyTo` and `scheduled_at` as `scheduledAt`.",
"required": [
"from",
"to",
"subject"
],
"properties": {
"from": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
"to": {
"oneOf": [
{
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
{
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
}
}
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 998
},
"cc": {
"oneOf": [
{
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
{
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
}
}
]
},
"bcc": {
"oneOf": [
{
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
{
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
}
}
]
},
"reply_to": {
"oneOf": [
{
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
{
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
}
}
]
},
"html": {
"type": "string"
},
"text": {
"type": "string"
},
"headers": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"attachments": {
"type": "array",
"maxItems": 50,
"items": {
"type": "object",
"required": [
"filename"
],
"description": "Provide exactly one of `content` or `path`.",
"properties": {
"filename": {
"type": "string",
"maxLength": 255
},
"content": {
"type": "string",
"description": "Base64-encoded file content."
},
"path": {
"type": "string",
"format": "uri",
"description": "A public URL fetched at send time."
},
"content_type": {
"type": "string",
"examples": [
"application/pdf"
]
},
"content_id": {
"type": "string",
"description": "Content-ID for inline images (`cid:`)."
}
}
}
},
"tags": {
"type": "array",
"maxItems": 50,
"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
}
}
}
},
"scheduled_at": {
"type": "string",
"description": "ISO 8601 date-time or natural language such as \"in 1 hour\" or \"in 2 days\". At most 30 days ahead.",
"examples": [
"in 1 hour",
"2026-10-30T09:00:00Z"
]
},
"tenant_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"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."
}
}
},
"description": "The JSON request body."
}
},
"required": [
"body"
]
}🟢get_email(id)
Retrieve an email. Requires a `full_access` API key. API: `GET /emails/{id}` (operationId `getEmail`, Emails).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "The email id."
}
},
"required": [
"id"
]
}🟡update_email(id, scheduled_at)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "The email id."
},
"scheduled_at": {
"type": "string",
"description": "ISO 8601 date-time or natural language such as \"in 1 hour\" or \"in 2 days\". At most 30 days ahead.",
"examples": [
"in 1 hour",
"2026-10-30T09:00:00Z"
]
}
},
"required": [
"id",
"scheduled_at"
]
}🔴cancel_email(id)
Cancel a scheduled email. Requires a `full_access` API key. API: `POST /emails/{id}/cancel` (operationId `cancelEmail`, Emails).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "The email id."
}
},
"required": [
"id"
]
}🟢list_domains(limit, after, before)
List domains. Requires a `full_access` API key. API: `GET /domains` (operationId `listDomains`, Domains).
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Number of items to return."
},
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
}🟡create_domain(name, region, custom_return_path, tenant_id)
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).
Esquema de entrada
{
"type": "object",
"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."
},
"custom_return_path": {
"type": "string",
"pattern": "^[a-z0-9-]{1,63}$",
"default": "send",
"description": "Subdomain used for the custom MAIL FROM (bounce handling and SPF)."
},
"tenant_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Platform mode. Make the domain tenant-owned (our tenant id or your `external_id`). Mail from it is attributed to that tenant."
}
},
"required": [
"name"
]
}🟢get_domain(id)
Retrieve a domain. Requires a `full_access` API key. API: `GET /domains/{id}` (operationId `getDomain`, Domains).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"id"
]
}🟡update_domain(id, open_tracking, click_tracking, tls)
Update a domain. Toggles open and click tracking. Requires a `full_access` API key. API: `PATCH /domains/{id}` (operationId `updateDomain`, Domains).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"open_tracking": {
"type": "boolean"
},
"click_tracking": {
"type": "boolean"
},
"tls": {
"type": "string",
"enum": [
"opportunistic",
"enforced"
]
}
},
"required": [
"id"
]
}🔴delete_domain(id)
Delete a domain. Requires a `full_access` API key. API: `DELETE /domains/{id}` (operationId `deleteDomain`, Domains).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"id"
]
}🟢verify_domain(id)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"id"
]
}🟢list_api_keys(limit, after, before)
List API keys. Requires a `full_access` API key. API: `GET /api-keys` (operationId `listApiKeys`, API Keys).
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Number of items to return."
},
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
}🟡create_api_key(name, permission, domain_id)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"permission": {
"type": "string",
"enum": [
"full_access",
"sending_access"
],
"default": "full_access"
},
"domain_id": {
"type": "string",
"format": "uuid",
"description": "Restrict a `sending_access` key to one of your domains. Not allowed with `full_access`."
}
},
"required": [
"name"
]
}🔴delete_api_key(id)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"id"
]
}🟢list_webhooks(limit, after, before)
List webhooks. Requires a `full_access` API key. API: `GET /webhooks` (operationId `listWebhooks`, Webhooks).
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Number of items to return."
},
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
}🟡create_webhook(endpoint, events)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"endpoint": {
"type": "string",
"format": "uri",
"description": "Public URL that receives POST requests. https is required in production."
},
"events": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"description": "Event names you can subscribe a webhook to.",
"enum": [
"email.sent",
"email.delivered",
"email.delivery_delayed",
"email.bounced",
"email.complained",
"email.opened",
"email.clicked",
"email.failed",
"email.scheduled",
"email.suppressed"
]
}
}
},
"required": [
"endpoint",
"events"
]
}🟢get_webhook(id)
Retrieve a webhook. Requires a `full_access` API key. API: `GET /webhooks/{id}` (operationId `getWebhook`, Webhooks).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"id"
]
}🟡update_webhook(id, endpoint, events, status)
Update a webhook. Requires a `full_access` API key. API: `PATCH /webhooks/{id}` (operationId `updateWebhook`, Webhooks).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"endpoint": {
"type": "string",
"format": "uri"
},
"events": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"description": "Event names you can subscribe a webhook to.",
"enum": [
"email.sent",
"email.delivered",
"email.delivery_delayed",
"email.bounced",
"email.complained",
"email.opened",
"email.clicked",
"email.failed",
"email.scheduled",
"email.suppressed"
]
}
},
"status": {
"type": "string",
"enum": [
"enabled",
"disabled"
]
}
},
"required": [
"id"
]
}🔴delete_webhook(id)
Delete a webhook. Requires a `full_access` API key. API: `DELETE /webhooks/{id}` (operationId `deleteWebhook`, Webhooks).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"id"
]
}🟢list_audiences(limit, after, before)
List audiences. Requires a `full_access` API key. API: `GET /audiences` (operationId `listAudiences`, Audiences).
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Number of items to return."
},
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
}🟡create_audience(name)
Create an audience. Requires a `full_access` API key. API: `POST /audiences` (operationId `createAudience`, Audiences).
Esquema de entrada
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"required": [
"name"
]
}🟢get_audience(id)
Retrieve an audience. Requires a `full_access` API key. API: `GET /audiences/{id}` (operationId `getAudience`, Audiences).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"id"
]
}🔴delete_audience(id)
Delete an audience. Also deletes its contacts. Requires a `full_access` API key. API: `DELETE /audiences/{id}` (operationId `deleteAudience`, Audiences).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"id"
]
}🟢list_contacts(audience_id, limit, after, before)
List contacts. Requires a `full_access` API key. API: `GET /audiences/{audienceId}/contacts` (operationId `listContacts`, Contacts).
Esquema de entrada
{
"type": "object",
"properties": {
"audience_id": {
"type": "string",
"format": "uuid"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Number of items to return."
},
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
},
"required": [
"audience_id"
]
}🟡create_contact(audience_id, email, first_name, last_name, unsubscribed)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"audience_id": {
"type": "string",
"format": "uuid"
},
"email": {
"type": "string",
"format": "email"
},
"first_name": {
"type": "string",
"maxLength": 100
},
"last_name": {
"type": "string",
"maxLength": 100
},
"unsubscribed": {
"type": "boolean",
"default": false
}
},
"required": [
"audience_id",
"email"
]
}🟢get_contact(audience_id, id_or_email)
Retrieve a contact. Requires a `full_access` API key. API: `GET /audiences/{audienceId}/contacts/{idOrEmail}` (operationId `getContact`, Contacts).
Esquema de entrada
{
"type": "object",
"properties": {
"audience_id": {
"type": "string",
"format": "uuid"
},
"id_or_email": {
"type": "string",
"description": "The contact id or its (URL-encoded) email address.",
"examples": [
"[email protected]"
]
}
},
"required": [
"audience_id",
"id_or_email"
]
}🟡update_contact(audience_id, id_or_email, first_name, last_name, unsubscribed)
Update a contact. Requires a `full_access` API key. API: `PATCH /audiences/{audienceId}/contacts/{idOrEmail}` (operationId `updateContact`, Contacts).
Esquema de entrada
{
"type": "object",
"properties": {
"audience_id": {
"type": "string",
"format": "uuid"
},
"id_or_email": {
"type": "string",
"description": "The contact id or its (URL-encoded) email address.",
"examples": [
"[email protected]"
]
},
"first_name": {
"type": "string",
"maxLength": 100
},
"last_name": {
"type": "string",
"maxLength": 100
},
"unsubscribed": {
"type": "boolean"
}
},
"required": [
"audience_id",
"id_or_email"
]
}🔴delete_contact(audience_id, id_or_email)
Delete a contact. Requires a `full_access` API key. API: `DELETE /audiences/{audienceId}/contacts/{idOrEmail}` (operationId `deleteContact`, Contacts).
Esquema de entrada
{
"type": "object",
"properties": {
"audience_id": {
"type": "string",
"format": "uuid"
},
"id_or_email": {
"type": "string",
"description": "The contact id or its (URL-encoded) email address.",
"examples": [
"[email protected]"
]
}
},
"required": [
"audience_id",
"id_or_email"
]
}🟢list_broadcasts(limit, after, before)
List broadcasts. Requires a `full_access` API key. API: `GET /broadcasts` (operationId `listBroadcasts`, Broadcasts).
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Number of items to return."
},
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
}🟡create_broadcast(audience_id, from, subject, reply_to, preview_text, ...)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"audience_id": {
"type": "string",
"format": "uuid"
},
"from": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 998
},
"reply_to": {
"oneOf": [
{
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
{
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
}
}
]
},
"preview_text": {
"type": "string",
"maxLength": 200
},
"html": {
"type": "string"
},
"text": {
"type": "string"
},
"name": {
"type": "string",
"maxLength": 100,
"description": "Internal name",
"not shown to recipients.": null
}
},
"required": [
"audience_id",
"from",
"subject"
]
}🟢get_broadcast(id)
Retrieve a broadcast. Requires a `full_access` API key. API: `GET /broadcasts/{id}` (operationId `getBroadcast`, Broadcasts).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"id"
]
}🟡update_broadcast(id, audience_id, from, subject, reply_to, ...)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"audience_id": {
"type": "string",
"format": "uuid"
},
"from": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 998
},
"reply_to": {
"oneOf": [
{
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
},
{
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "string",
"description": "An email address, optionally with a display name: `Acme <[email protected]>`.",
"examples": [
"Acme <[email protected]>"
]
}
}
]
},
"preview_text": {
"type": "string",
"maxLength": 200
},
"html": {
"type": "string"
},
"text": {
"type": "string"
},
"name": {
"type": "string",
"maxLength": 100
}
},
"required": [
"id"
]
}🔴delete_broadcast(id)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"id"
]
}🟢get_broadcast_readiness(id)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"id"
]
}🟡send_broadcast(id, scheduled_at)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"scheduled_at": {
"type": "string",
"description": "ISO 8601 date-time or natural language such as \"in 1 hour\" or \"in 2 days\". At most 30 days ahead.",
"examples": [
"in 1 hour",
"2026-10-30T09:00:00Z"
]
}
},
"required": [
"id"
]
}🟢list_suppressions(limit, after, before)
List suppressions. Requires a `full_access` API key. API: `GET /suppressions` (operationId `listSuppressions`, Suppressions).
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Number of items to return."
},
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
}🟡create_suppression(email)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"email": {
"type": "string",
"format": "email"
}
},
"required": [
"email"
]
}🔴delete_suppression(id_or_email)
Remove a suppression. Requires a `full_access` API key. API: `DELETE /suppressions/{idOrEmail}` (operationId `deleteSuppression`, Suppressions).
Esquema de entrada
{
"type": "object",
"properties": {
"id_or_email": {
"type": "string",
"description": "The suppression id or the (URL-encoded) email address.",
"examples": [
"[email protected]"
]
}
},
"required": [
"id_or_email"
]
}🟢list_tenants(limit, after, before)
List tenants. Requires a `full_access` API key. API: `GET /tenants` (operationId `listTenants`, Tenants).
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Number of items to return."
},
"after": {
"type": "string",
"format": "uuid",
"description": "Return items older than this id (next page). Cannot be combined with `before`."
},
"before": {
"type": "string",
"format": "uuid",
"description": "Return items newer than this id (previous page). Cannot be combined with `after`."
}
}
}🟡create_tenant(name, external_id, daily_limit)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"external_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your own id for the customer. Unique per account; accepted wherever a tenant id is."
},
"daily_limit": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "Max recipients per day for this tenant. Omit or null for no cap."
}
},
"required": [
"name"
]
}🟢get_tenant(ref)
Retrieve a tenant. Requires a `full_access` API key. API: `GET /tenants/{ref}` (operationId `getTenant`, Tenants).
Esquema de entrada
{
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The tenant id or your own `external_id`.",
"examples": [
"cust_123"
]
}
},
"required": [
"ref"
]
}🟡update_tenant(ref, name, external_id, daily_limit)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The tenant id or your own `external_id`.",
"examples": [
"cust_123"
]
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"external_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"daily_limit": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "Null removes the cap."
}
},
"required": [
"ref"
]
}🔴delete_tenant(ref)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The tenant id or your own `external_id`.",
"examples": [
"cust_123"
]
}
},
"required": [
"ref"
]
}🔴pause_tenant(ref, reason)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The tenant id or your own `external_id`.",
"examples": [
"cust_123"
]
},
"reason": {
"type": "string",
"maxLength": 300,
"description": "Stored as `paused_reason`. Defaults to a generic reason."
}
},
"required": [
"ref"
]
}🟢unpause_tenant(ref)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The tenant id or your own `external_id`.",
"examples": [
"cust_123"
]
}
},
"required": [
"ref"
]
}Comunidad
Evidencia