Agent inboxes

Create an agent inbox

A real inbox for an AI agent on one of the workspace's verified domains (a workspace owner/admin's key). Agents don't count as paid seats; each plan includes some. With createKey, the answer carries a new agent key (shown once).

post/api/v1/inboxes

Request

  • Base URL: https://supermailos.com
  • URL: https://supermailos.com/api/v1/inboxes
  • Auth: HTTP bearer

Request body

namestring required
descriptionstring
sponsorUserIdstring

A person in the workspace (admins only).

sendMode'approval' | 'known' | 'open'
inboundMode'all' | 'verified' | 'allowlist'
dailySendCapinteger
newRecipientsDailyCapinteger
allowSendersstring[]
blockSendersstring[]
allowRecipientsstring[]
disclosureboolean

End its mail with a line saying an AI agent sent it, for whom (admins only).

localPartstring

The part before the @. Made from the name when omitted.

domainstring

A verified domain name or id. The first verified one when omitted.

Response

Created.

Changes

No recorded changes to this operation across all 1 revision of this API.