> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. # API Reference > AgentMail is the first email provider built for AI agents. Create inboxes, send and receive messages, manage threads, and handle webhooks programmatically. Free tier, no credit card required. ## API Docs - API Reference > Agent [Sign Up](https://agentmail.to/docs/api-reference/agent/sign-up.md) - API Reference > Agent [Attach Human](https://agentmail.to/docs/api-reference/agent/attach-human.md) - API Reference > Agent [Verify](https://agentmail.to/docs/api-reference/agent/verify.md) - API Reference > Inboxes [List Inboxes](https://agentmail.to/docs/api-reference/inboxes/list.md) - API Reference > Inboxes [Search Inboxes](https://agentmail.to/docs/api-reference/inboxes/search.md) - API Reference > Inboxes [Get Inbox](https://agentmail.to/docs/api-reference/inboxes/get.md) - API Reference > Inboxes [Create Inbox](https://agentmail.to/docs/api-reference/inboxes/create.md) - API Reference > Inboxes [Update Inbox](https://agentmail.to/docs/api-reference/inboxes/update.md) - API Reference > Inboxes [Delete Inbox](https://agentmail.to/docs/api-reference/inboxes/delete.md) - API Reference > Inboxes [Authorize Inbox](https://agentmail.to/docs/api-reference/inboxes/authorize.md) - API Reference > Inboxes > Threads [List Threads](https://agentmail.to/docs/api-reference/inboxes/threads/list.md) - API Reference > Inboxes > Threads [Search Threads](https://agentmail.to/docs/api-reference/inboxes/threads/search.md) - API Reference > Inboxes > Threads [Get Thread](https://agentmail.to/docs/api-reference/inboxes/threads/get.md) - API Reference > Inboxes > Threads [Get Attachment](https://agentmail.to/docs/api-reference/inboxes/threads/get-attachment.md) - API Reference > Inboxes > Threads [Update Thread](https://agentmail.to/docs/api-reference/inboxes/threads/update.md) - API Reference > Inboxes > Threads [Delete Thread](https://agentmail.to/docs/api-reference/inboxes/threads/delete.md) - API Reference > Inboxes > Messages [List Messages](https://agentmail.to/docs/api-reference/inboxes/messages/list.md) - API Reference > Inboxes > Messages [Search Messages](https://agentmail.to/docs/api-reference/inboxes/messages/search.md) - API Reference > Inboxes > Messages [Get Message](https://agentmail.to/docs/api-reference/inboxes/messages/get.md) - API Reference > Inboxes > Messages [Batch Get Messages](https://agentmail.to/docs/api-reference/inboxes/messages/batch-get.md) - API Reference > Inboxes > Messages [Batch Update Messages](https://agentmail.to/docs/api-reference/inboxes/messages/batch-update.md) - API Reference > Inboxes > Messages [Get Attachment](https://agentmail.to/docs/api-reference/inboxes/messages/get-attachment.md) - API Reference > Inboxes > Messages [Get Raw Message](https://agentmail.to/docs/api-reference/inboxes/messages/get-raw.md) - API Reference > Inboxes > Messages [Update Message](https://agentmail.to/docs/api-reference/inboxes/messages/update.md) - API Reference > Inboxes > Messages [Delete Message](https://agentmail.to/docs/api-reference/inboxes/messages/delete.md) - API Reference > Inboxes > Messages [Send Message](https://agentmail.to/docs/api-reference/inboxes/messages/send.md) - API Reference > Inboxes > Messages [Reply To Message](https://agentmail.to/docs/api-reference/inboxes/messages/reply.md) - API Reference > Inboxes > Messages [Reply All Message](https://agentmail.to/docs/api-reference/inboxes/messages/reply-all.md) - API Reference > Inboxes > Messages [Forward Message](https://agentmail.to/docs/api-reference/inboxes/messages/forward.md) - API Reference > Inboxes > Drafts [List Drafts](https://agentmail.to/docs/api-reference/inboxes/drafts/list.md) - API Reference > Inboxes > Drafts [Get Draft](https://agentmail.to/docs/api-reference/inboxes/drafts/get.md) - API Reference > Inboxes > Drafts [Get Attachment](https://agentmail.to/docs/api-reference/inboxes/drafts/get-attachment.md) - API Reference > Inboxes > Drafts [Create Draft](https://agentmail.to/docs/api-reference/inboxes/drafts/create.md) - API Reference > Inboxes > Drafts [Update Draft](https://agentmail.to/docs/api-reference/inboxes/drafts/update.md) - API Reference > Inboxes > Drafts [Delete Draft](https://agentmail.to/docs/api-reference/inboxes/drafts/delete.md) - API Reference > Inboxes > Drafts [Send Draft](https://agentmail.to/docs/api-reference/inboxes/drafts/send.md) - API Reference > Inboxes > Webhooks [List Webhooks](https://agentmail.to/docs/api-reference/inboxes/webhooks/list.md) - API Reference > Inboxes > Webhooks [Get Webhook](https://agentmail.to/docs/api-reference/inboxes/webhooks/get.md) - API Reference > Inboxes > Webhooks [Get Webhook Headers](https://agentmail.to/docs/api-reference/inboxes/webhooks/get-headers.md) - API Reference > Inboxes > Webhooks [Create Webhook](https://agentmail.to/docs/api-reference/inboxes/webhooks/create.md) - API Reference > Inboxes > Webhooks [Update Webhook](https://agentmail.to/docs/api-reference/inboxes/webhooks/update.md) - API Reference > Inboxes > Webhooks [Update Webhook Headers](https://agentmail.to/docs/api-reference/inboxes/webhooks/update-headers.md) - API Reference > Inboxes > Webhooks [Delete Webhook](https://agentmail.to/docs/api-reference/inboxes/webhooks/delete.md) - API Reference > Inboxes > Webhooks > Polling [List Polling Webhooks](https://agentmail.to/docs/api-reference/inboxes/webhooks/polling/list.md) - API Reference > Inboxes > Webhooks > Polling [Get Polling Webhook](https://agentmail.to/docs/api-reference/inboxes/webhooks/polling/get.md) - API Reference > Inboxes > Webhooks > Polling [Create Polling Webhook](https://agentmail.to/docs/api-reference/inboxes/webhooks/polling/create.md) - API Reference > Inboxes > Webhooks > Polling [Delete Polling Webhook](https://agentmail.to/docs/api-reference/inboxes/webhooks/polling/delete.md) - API Reference > Inboxes > Lists [List Entries](https://agentmail.to/docs/api-reference/inboxes/lists/list.md) - API Reference > Inboxes > Lists [Get List Entry](https://agentmail.to/docs/api-reference/inboxes/lists/get.md) - API Reference > Inboxes > Lists [Create List Entry](https://agentmail.to/docs/api-reference/inboxes/lists/create.md) - API Reference > Inboxes > Lists [Delete List Entry](https://agentmail.to/docs/api-reference/inboxes/lists/delete.md) - API Reference > Inboxes > Metrics [Query Events](https://agentmail.to/docs/api-reference/inboxes/metrics/query-events.md) - API Reference > Inboxes > Metrics [Query Usage](https://agentmail.to/docs/api-reference/inboxes/metrics/query-usage.md) - API Reference > Inboxes > Metrics [Query Rates](https://agentmail.to/docs/api-reference/inboxes/metrics/query-rates.md) - API Reference > Inboxes > Events [List Inbox Events](https://agentmail.to/docs/api-reference/inboxes/events/list.md) - API Reference > Inboxes > API Keys [List API Keys](https://agentmail.to/docs/api-reference/inboxes/api-keys/list.md) - API Reference > Inboxes > API Keys [Create API Key](https://agentmail.to/docs/api-reference/inboxes/api-keys/create.md) - API Reference > Inboxes > API Keys [Update API Key](https://agentmail.to/docs/api-reference/inboxes/api-keys/update.md) - API Reference > Inboxes > API Keys [Delete API Key](https://agentmail.to/docs/api-reference/inboxes/api-keys/delete.md) - API Reference > Inboxes > Accounts [List Accounts](https://agentmail.to/docs/api-reference/inboxes/accounts/list.md) - API Reference > Inboxes > Accounts [Get Account](https://agentmail.to/docs/api-reference/inboxes/accounts/get.md) - API Reference > Inboxes > Calendar [Get Calendar](https://agentmail.to/docs/api-reference/inboxes/calendar/get.md) - API Reference > Inboxes > Calendar [Update Calendar](https://agentmail.to/docs/api-reference/inboxes/calendar/update.md) - API Reference > Inboxes > Calendar [List Events](https://agentmail.to/docs/api-reference/inboxes/calendar/list-events.md) - API Reference > Inboxes > Calendar [Get Agenda](https://agentmail.to/docs/api-reference/inboxes/calendar/get-agenda.md) - API Reference > Inboxes > Calendar [Create Event](https://agentmail.to/docs/api-reference/inboxes/calendar/create-event.md) - API Reference > Inboxes > Calendar [Get Event](https://agentmail.to/docs/api-reference/inboxes/calendar/get-event.md) - API Reference > Inboxes > Calendar [Update Event](https://agentmail.to/docs/api-reference/inboxes/calendar/update-event.md) - API Reference > Inboxes > Calendar [Delete Event](https://agentmail.to/docs/api-reference/inboxes/calendar/delete-event.md) - API Reference > Inboxes > Calendar [List Event Instances](https://agentmail.to/docs/api-reference/inboxes/calendar/list-event-instances.md) - API Reference > Inboxes > Calendar [Respond to Event](https://agentmail.to/docs/api-reference/inboxes/calendar/respond-to-event.md) - API Reference > Threads [List Threads](https://agentmail.to/docs/api-reference/threads/list.md) - API Reference > Threads [Search Threads](https://agentmail.to/docs/api-reference/threads/search.md) - API Reference > Threads [Get Thread](https://agentmail.to/docs/api-reference/threads/get.md) - API Reference > Threads [Get Attachment](https://agentmail.to/docs/api-reference/threads/get-attachment.md) - API Reference > Threads [Update Thread](https://agentmail.to/docs/api-reference/threads/update.md) - API Reference > Threads [Delete Thread](https://agentmail.to/docs/api-reference/threads/delete.md) - API Reference > Drafts [List Drafts](https://agentmail.to/docs/api-reference/drafts/list.md) - API Reference > Drafts [Get Draft](https://agentmail.to/docs/api-reference/drafts/get.md) - API Reference > Drafts [Get Attachment](https://agentmail.to/docs/api-reference/drafts/get-attachment.md) - API Reference > Webhooks [List Webhooks](https://agentmail.to/docs/api-reference/webhooks/list.md) - API Reference > Webhooks [Get Webhook](https://agentmail.to/docs/api-reference/webhooks/get.md) - API Reference > Webhooks [Get Webhook Headers](https://agentmail.to/docs/api-reference/webhooks/get-headers.md) - API Reference > Webhooks [Create Webhook](https://agentmail.to/docs/api-reference/webhooks/create.md) - API Reference > Webhooks [Update Webhook](https://agentmail.to/docs/api-reference/webhooks/update.md) - API Reference > Webhooks [Update Webhook Headers](https://agentmail.to/docs/api-reference/webhooks/update-headers.md) - API Reference > Webhooks [Delete Webhook](https://agentmail.to/docs/api-reference/webhooks/delete.md) - API Reference > Webhooks > Events [Message Received](https://agentmail.to/docs/api-reference/webhooks/events/message-received.md) - API Reference > Webhooks > Events [Message Sent](https://agentmail.to/docs/api-reference/webhooks/events/message-sent.md) - API Reference > Webhooks > Events [Message Delivered](https://agentmail.to/docs/api-reference/webhooks/events/message-delivered.md) - API Reference > Webhooks > Events [Message Bounced](https://agentmail.to/docs/api-reference/webhooks/events/message-bounced.md) - API Reference > Webhooks > Events [Message Complained](https://agentmail.to/docs/api-reference/webhooks/events/message-complained.md) - API Reference > Webhooks > Events [Message Rejected](https://agentmail.to/docs/api-reference/webhooks/events/message-rejected.md) - API Reference > Webhooks > Events [Message Opened](https://agentmail.to/docs/api-reference/webhooks/events/message-opened.md) - API Reference > Webhooks > Events [Domain Verified](https://agentmail.to/docs/api-reference/webhooks/events/domain-verified.md) - API Reference > Webhooks > Events [Calendar Event Created](https://agentmail.to/docs/api-reference/webhooks/events/calendar-event-created.md) - API Reference > Webhooks > Events [Calendar Event Updated](https://agentmail.to/docs/api-reference/webhooks/events/calendar-event-updated.md) - API Reference > Webhooks > Events [Calendar Event Deleted](https://agentmail.to/docs/api-reference/webhooks/events/calendar-event-deleted.md) - API Reference > Webhooks > Events [Calendar Event Responded](https://agentmail.to/docs/api-reference/webhooks/events/calendar-event-responded.md) - API Reference > Webhooks > Events [Calendar Event Starting](https://agentmail.to/docs/api-reference/webhooks/events/calendar-event-starting.md) - API Reference > Webhooks > Events [Calendar Event Ending](https://agentmail.to/docs/api-reference/webhooks/events/calendar-event-ending.md) - API Reference > Webhooks > Polling [List Polling Webhooks](https://agentmail.to/docs/api-reference/webhooks/polling/list.md) - API Reference > Webhooks > Polling [Get Polling Webhook](https://agentmail.to/docs/api-reference/webhooks/polling/get.md) - API Reference > Webhooks > Polling [Create Polling Webhook](https://agentmail.to/docs/api-reference/webhooks/polling/create.md) - API Reference > Webhooks > Polling [Delete Polling Webhook](https://agentmail.to/docs/api-reference/webhooks/polling/delete.md) - API Reference > Websockets [Connect](https://agentmail.to/docs/api-reference/websockets/websockets.md) - API Reference > Domains [List Domains](https://agentmail.to/docs/api-reference/domains/list.md) - API Reference > Domains [Get Domain](https://agentmail.to/docs/api-reference/domains/get.md) - API Reference > Domains [Get Zone File](https://agentmail.to/docs/api-reference/domains/get-zone-file.md) - API Reference > Domains [Create Domain](https://agentmail.to/docs/api-reference/domains/create.md) - API Reference > Domains [Update Domain](https://agentmail.to/docs/api-reference/domains/update.md) - API Reference > Domains [Delete Domain](https://agentmail.to/docs/api-reference/domains/delete.md) - API Reference > Domains [Verify Domain](https://agentmail.to/docs/api-reference/domains/verify.md) - API Reference > Domains [Get Setup Link](https://agentmail.to/docs/api-reference/domains/get-setup-link.md) - API Reference > Lists [List Entries](https://agentmail.to/docs/api-reference/lists/list.md) - API Reference > Lists [Get List Entry](https://agentmail.to/docs/api-reference/lists/get.md) - API Reference > Lists [Create List Entry](https://agentmail.to/docs/api-reference/lists/create.md) - API Reference > Lists [Delete List Entry](https://agentmail.to/docs/api-reference/lists/delete.md) - API Reference > Metrics [Query Events](https://agentmail.to/docs/api-reference/metrics/query-events.md) - API Reference > Metrics [Query Usage](https://agentmail.to/docs/api-reference/metrics/query-usage.md) - API Reference > Metrics [Query Rates](https://agentmail.to/docs/api-reference/metrics/query-rates.md) - API Reference > API Keys [List API Keys](https://agentmail.to/docs/api-reference/api-keys/list.md) - API Reference > API Keys [Get API Key](https://agentmail.to/docs/api-reference/api-keys/get.md) - API Reference > API Keys [Create API Key](https://agentmail.to/docs/api-reference/api-keys/create.md) - API Reference > API Keys [Update API Key](https://agentmail.to/docs/api-reference/api-keys/update.md) - API Reference > API Keys [Delete API Key](https://agentmail.to/docs/api-reference/api-keys/delete.md) - API Reference > Apps [List Apps](https://agentmail.to/docs/api-reference/apps/list.md) - API Reference > Apps [Search Apps](https://agentmail.to/docs/api-reference/apps/search.md) - API Reference > Apps [Get App](https://agentmail.to/docs/api-reference/apps/get.md) - API Reference > Apps [List App Accounts](https://agentmail.to/docs/api-reference/apps/list-accounts.md) - API Reference > Apps [Connect App](https://agentmail.to/docs/api-reference/apps/connect.md) - API Reference > Accounts [List Accounts](https://agentmail.to/docs/api-reference/accounts/list.md) - API Reference > Accounts [Get Account](https://agentmail.to/docs/api-reference/accounts/get.md) - API Reference > Accounts [Update Account](https://agentmail.to/docs/api-reference/accounts/update.md) - API Reference > Pods [List Pods](https://agentmail.to/docs/api-reference/pods/list.md) - API Reference > Pods [Get Pod](https://agentmail.to/docs/api-reference/pods/get.md) - API Reference > Pods [Create Pod](https://agentmail.to/docs/api-reference/pods/create.md) - API Reference > Pods [Delete Pod](https://agentmail.to/docs/api-reference/pods/delete.md) - API Reference > Pods > Inboxes [List Inboxes](https://agentmail.to/docs/api-reference/pods/inboxes/list.md) - API Reference > Pods > Inboxes [Search Inboxes](https://agentmail.to/docs/api-reference/pods/inboxes/search.md) - API Reference > Pods > Inboxes [Get Inbox](https://agentmail.to/docs/api-reference/pods/inboxes/get.md) - API Reference > Pods > Inboxes [Create Inbox](https://agentmail.to/docs/api-reference/pods/inboxes/create.md) - API Reference > Pods > Inboxes [Update Inbox](https://agentmail.to/docs/api-reference/pods/inboxes/update.md) - API Reference > Pods > Inboxes [Delete Inbox](https://agentmail.to/docs/api-reference/pods/inboxes/delete.md) - API Reference > Pods > Threads [List Threads](https://agentmail.to/docs/api-reference/pods/threads/list.md) - API Reference > Pods > Threads [Search Threads](https://agentmail.to/docs/api-reference/pods/threads/search.md) - API Reference > Pods > Threads [Get Thread](https://agentmail.to/docs/api-reference/pods/threads/get.md) - API Reference > Pods > Threads [Get Attachment](https://agentmail.to/docs/api-reference/pods/threads/get-attachment.md) - API Reference > Pods > Threads [Update Thread](https://agentmail.to/docs/api-reference/pods/threads/update.md) - API Reference > Pods > Threads [Delete Thread](https://agentmail.to/docs/api-reference/pods/threads/delete.md) - API Reference > Pods > Drafts [List Drafts](https://agentmail.to/docs/api-reference/pods/drafts/list.md) - API Reference > Pods > Drafts [Get Draft](https://agentmail.to/docs/api-reference/pods/drafts/get.md) - API Reference > Pods > Drafts [Get Attachment](https://agentmail.to/docs/api-reference/pods/drafts/get-attachment.md) - API Reference > Pods > Webhooks [List Webhooks](https://agentmail.to/docs/api-reference/pods/webhooks/list.md) - API Reference > Pods > Webhooks [Get Webhook](https://agentmail.to/docs/api-reference/pods/webhooks/get.md) - API Reference > Pods > Webhooks [Get Webhook Headers](https://agentmail.to/docs/api-reference/pods/webhooks/get-headers.md) - API Reference > Pods > Webhooks [Create Webhook](https://agentmail.to/docs/api-reference/pods/webhooks/create.md) - API Reference > Pods > Webhooks [Update Webhook](https://agentmail.to/docs/api-reference/pods/webhooks/update.md) - API Reference > Pods > Webhooks [Update Webhook Headers](https://agentmail.to/docs/api-reference/pods/webhooks/update-headers.md) - API Reference > Pods > Webhooks [Delete Webhook](https://agentmail.to/docs/api-reference/pods/webhooks/delete.md) - API Reference > Pods > Webhooks > Polling [List Polling Webhooks](https://agentmail.to/docs/api-reference/pods/webhooks/polling/list.md) - API Reference > Pods > Webhooks > Polling [Get Polling Webhook](https://agentmail.to/docs/api-reference/pods/webhooks/polling/get.md) - API Reference > Pods > Webhooks > Polling [Create Polling Webhook](https://agentmail.to/docs/api-reference/pods/webhooks/polling/create.md) - API Reference > Pods > Webhooks > Polling [Delete Polling Webhook](https://agentmail.to/docs/api-reference/pods/webhooks/polling/delete.md) - API Reference > Pods > Domains [List Domains](https://agentmail.to/docs/api-reference/pods/domains/list.md) - API Reference > Pods > Domains [Get Domain](https://agentmail.to/docs/api-reference/pods/domains/get.md) - API Reference > Pods > Domains [Get Zone File](https://agentmail.to/docs/api-reference/pods/domains/get-zone-file.md) - API Reference > Pods > Domains [Create Domain](https://agentmail.to/docs/api-reference/pods/domains/create.md) - API Reference > Pods > Domains [Update Domain](https://agentmail.to/docs/api-reference/pods/domains/update.md) - API Reference > Pods > Domains [Delete Domain](https://agentmail.to/docs/api-reference/pods/domains/delete.md) - API Reference > Pods > Domains [Verify Domain](https://agentmail.to/docs/api-reference/pods/domains/verify.md) - API Reference > Pods > Lists [List Entries](https://agentmail.to/docs/api-reference/pods/lists/list.md) - API Reference > Pods > Lists [Get List Entry](https://agentmail.to/docs/api-reference/pods/lists/get.md) - API Reference > Pods > Lists [Create List Entry](https://agentmail.to/docs/api-reference/pods/lists/create.md) - API Reference > Pods > Lists [Delete List Entry](https://agentmail.to/docs/api-reference/pods/lists/delete.md) - API Reference > Pods > Metrics [Query Events](https://agentmail.to/docs/api-reference/pods/metrics/query-events.md) - API Reference > Pods > Metrics [Query Usage](https://agentmail.to/docs/api-reference/pods/metrics/query-usage.md) - API Reference > Pods > Metrics [Query Rates](https://agentmail.to/docs/api-reference/pods/metrics/query-rates.md) - API Reference > Pods > API Keys [List API Keys](https://agentmail.to/docs/api-reference/pods/api-keys/list.md) - API Reference > Pods > API Keys [Create API Key](https://agentmail.to/docs/api-reference/pods/api-keys/create.md) - API Reference > Pods > API Keys [Update API Key](https://agentmail.to/docs/api-reference/pods/api-keys/update.md) - API Reference > Pods > API Keys [Delete API Key](https://agentmail.to/docs/api-reference/pods/api-keys/delete.md) - API Reference > Pods > Accounts [List Accounts](https://agentmail.to/docs/api-reference/pods/accounts/list.md) - API Reference > Pods > Accounts [Get Account](https://agentmail.to/docs/api-reference/pods/accounts/get.md) - API Reference > Organizations [Get Organization](https://agentmail.to/docs/api-reference/organizations/get.md) - API Reference > Auth [Who Am I](https://agentmail.to/docs/api-reference/auth/me.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://agentmail.to/docs/api-reference/openapi.json) - [OpenAPI YAML](https://agentmail.to/docs/api-reference/openapi.yaml) ## AsyncAPI Specification The raw AsyncAPI 2.6.0 specification for the WebSocket channels is available at: - [AsyncAPI JSON](https://agentmail.to/docs/api-reference/asyncapi.json) - [AsyncAPI YAML](https://agentmail.to/docs/api-reference/asyncapi.yaml) > **Note:** This page contains both a page directory (above) and the landing page content (below). The page directory is generated for agent use and does not appear on the landing page. > For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.agentmail.to/llms.txt. # API Welcome > Quick overview of the AgentMail SDK ## Introduction AgentMail provides a powerful API for managing email communications programmatically. Whether you're building automated testing systems, handling customer support workflows, or developing email-based applications, our API offers the tools you need! ## Base URL All API requests should be made to the following base URL: ``` https://api.agentmail.to/v0/ ``` ## Available SDKs #### [Python SDK](https://github.com/agentmail-to/agentmail-python) Use our Python SDK for seamless integration with your Python applications. #### [Node SDK](https://github.com/agentmail-to/agentmail-node) Use our Node SDK for seamless integration with your Node applications. ## Contribute We welcome contributions to our SDKs. If you have any suggestions or improvements, please feel free to open a pull request! If you have any other languages you would like us to support, please [reach out to us](mailto:support@agentmail.cc). ## License All of our SDKs are open source and available under the MIT license.