AgentMail

Create a new email inbox. Inboxes cost $2/month. Inboxes with no API activity for 30+ days are automatically deleted. Any request using the inbox resets the inactivity timer. Returns an inbox_id in email format (e.g., myagent@agentmail.to) used for all subsequent operations. If username is omitted, a random one is generated.

Changed on
post/agentmail/v0/inboxes

Request

Request body

usernamestring

Local part of the email address (e.g., myagent becomes myagent@agentmail.to). Randomly generated if omitted.

domainstring

Email domain. Must be a verified custom domain. Defaults to agentmail.to.

display_namestring

Human-readable name shown in the From header (e.g., My Agent myagent@agentmail.to).

client_idstring

Your own identifier to associate with this inbox.

Response

Successful response

Changes