Mailboxes

Create a mailbox

post/mailboxes

Request

  • Base URL: https://api.tinysend.com/v1
  • URL: https://api.tinysend.com/v1/mailboxes
  • Auth: HTTP bearer

Request body

addressstring

Full email address (slug@domain). Optional for disposable mailboxes — a readable address (e.g. swift-otter@tinysend.com) is auto-generated when omitted.

namestring
type'persistent' | 'disposable' | 'proxy'
configobject
expires_atstring date-time

ISO 8601 expiry for disposable mailboxes (max 30 days out). Alternative to ttl.

domainstring

Domain for an auto-generated disposable address. Defaults to tinysend.com.

list_idstring

Link mailbox to existing list

Response

Created mailbox

idstring required
addressstring required
local_partstring required
domainstring required
namestring nullable required
typestring required
statusstring required
list_idstring nullable required
configobject nullable required
expires_atstring nullable required
created_atstring required

Changes

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