AgentMail

Add a custom domain.

POST JSON body. Returns domain with DNS records needed for verification.

List all custom domains.

GET with optional pagination. Returns verified and pending custom domains.

Get domain details and verification status.

Replace {domain_id}. Returns domain status and required DNS records.

Delete a custom domain.

Permanently removes the custom domain.

Trigger domain verification.

Triggers DNS verification for the domain. Check domain status after.

Get DNS zone file for a domain.

Returns the DNS zone file with required records for domain verification.

List all drafts across all inboxes.

GET with optional filters. Returns drafts across all inboxes ordered by updated_at.

Get a draft by ID.

Replace {draft_id}. Returns draft details including to, subject, text, html, and attachments.

Create a new inbox with a real email address.

POST JSON body. Returns the created inbox. The inbox can immediately send and receive email.

List all inboxes.

GET with optional pagination. Returns inboxes ordered by created_at descending.

Update inbox display name.

PATCH JSON body with display_name.

Delete an inbox.

Permanently deletes the inbox and all its messages.

Get inbox details.

Replace {inbox_id}. Returns inbox details including pod_id, display_name, and timestamps.

List drafts in an inbox.

Replace {inbox_id}. Returns drafts ordered by updated_at.

Create a draft email.

Replace {inbox_id}. POST JSON body. Use send_at for scheduled sending.

Delete a draft.

Permanently deletes the draft.

Update a draft.

PATCH JSON body with fields to update.

Get a draft in an inbox.

Replace path params. Returns full draft details.

Send a draft email.

Sends the draft. Optionally update labels before sending. Returns message_id and thread_id.

List messages in an inbox.

Replace {inbox_id}. Returns messages ordered by timestamp. Use labels, before/after, and include_spam to filter.

Get a specific message.

Returns the full message with from, to, subject, text, html, extracted_text, attachments, headers, and timestamps.

Update message labels.

PATCH JSON body to add or remove labels on the message.

Get a message attachment.

Returns attachment metadata with a temporary download_url and expires_at.

Forward a message.

Forward the message to new recipients. Returns message_id and thread_id.

Get raw email message (RFC 2822).

Returns the raw email message content.

Reply to a message.

POST reply content. Set reply_all: true to reply to all recipients. Returns message_id and thread_id.

Reply all to a message.

Replies to all recipients of the original message. Returns message_id and thread_id.

Send an email from an inbox.

Replace {inbox_id}. POST JSON body with 'to' and message content. Returns message_id and thread_id.

Get email metrics for an inbox.

Returns message metrics (sent, delivered, bounced, delayed, rejected, complained, received timestamps) for the time range.

List email threads in an inbox.

Returns conversation threads. Each thread groups related messages with senders, recipients, subject, preview, and message_count.

Delete a thread.

Permanently deletes the thread and its messages.

Get a thread with all its messages.

Returns the thread with all messages in the conversation ordered by timestamp ascending.

Get a thread attachment.

Returns attachment metadata with download_url and expires_at.

Get email metrics across all inboxes.

Returns aggregated message metrics across all inboxes for the time range.

Get current organization details.

Returns organization info including inbox_count, domain_count, inbox_limit, and domain_limit.

Create a new pod.

POST JSON body. Creates a pod to group inboxes.

List all pods.

GET with optional pagination. Pods group inboxes together.

Get pod details.

Replace {pod_id}. Returns pod details.

Delete a pod.

Permanently deletes the pod.

List domains in a pod.

Replace {pod_id}. Returns domains associated with the pod.

Add a domain to a pod.

Creates a custom domain scoped to the pod.

Remove a domain from a pod.

Deletes the domain from the pod.

List drafts across all inboxes in a pod.

Returns drafts from all inboxes in the pod.

Get a draft in a pod.

Returns draft details.

List inboxes in a pod.

Returns inboxes belonging to the pod.

Create an inbox in a pod.

Creates an inbox scoped to the pod.

Get an inbox in a pod.

Returns inbox details within the pod.

Delete an inbox from a pod.

Permanently deletes the inbox from the pod.

List threads across all inboxes in a pod.

Returns threads from all inboxes in the pod.

Get a thread in a pod.

Returns the thread with all messages.

Get a thread attachment in a pod.

Returns attachment metadata with download_url.

List all threads across all inboxes.

Returns threads across all inboxes ordered by timestamp.

Get a thread by ID.

Returns the thread with all messages.

Get a thread attachment.

Returns attachment metadata with download_url and expires_at.

Create a webhook for email events.

POST JSON body with url and event_types. Returns webhook with secret for signature verification.

List all webhooks.

GET with optional pagination. Returns configured webhooks.

Delete a webhook.

Permanently deletes the webhook.

Update webhook subscriptions.

PATCH to add/remove inbox or pod subscriptions.

Get webhook details.

Replace {webhook_id}. Returns webhook details including secret and enabled status.