> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Email API accepts attachments

The [Email API](/docs/channels/email/email-configuration/implementation-method#api) now accepts the files that end users attach to a contact form. Your AI Agent handles them the same way as attachments on an email sent to it directly.

## What's new

The `POST /v2/conversations/email/` endpoint accepts a new request format. JSON requests work as before.

* **Multipart requests**: send the request as `multipart/form-data`, with the JSON body in a `data` part and one `attachments` part per file. See [Start a conversation over Ada's email channel](/reference/conversations/create-email-conversation).
* **Attachment handling applies**: files follow the [attachment handling](/docs/channels/email/email-configuration/email-handoffs/attachment-handling) setting of the inbox the AI Agent replies from. On inboxes set to **AI Agent replies using the attachment**, the AI Agent reads up to 3 images. On the default **Hand off to a human**, the inquiry is handed off with its files.
* **Limits**: a request can include up to 10 attachments and 30 MB in total. A request with more files returns `400 Bad Request`, and a larger one returns `413 Content Too Large`.