Inboxes

Create an inbox

Creates name@<domain> on the install's default mail domain (send0.email on send0.dev), or on domain if given. Omit name for a random address.

post/v1/inboxes

Request

  • Base URL: https://api.send0.dev
  • URL: https://api.send0.dev/v1/inboxes
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Retry-safe POSTs: same key + same body returns the stored response for 24 hours.

Request body

namestring
domainstring
display_namestring nullable
send_policy'open' | 'reply_only' | 'approval'
retention_daysinteger

Days to keep message content (1 to 30, default 7). After that, bodies, extracted fields, attachments and the raw message are deleted and the message reads as expired: true; the rest of the message is deleted after 35 days.

metadataobject
expires_atstring date-time

Response

Inbox

object'inbox' required
idstring required
addressstring required
local_partstring required
domainstring required
display_namestring nullable required
mode'live' | 'sandbox' required
send_policy'open' | 'reply_only' | 'approval' required
status'active' | 'suspended' | 'deleted' required
retention_daysinteger required
metadataobject required
expires_atstring date-time nullable required
created_atstring date-time required
updated_atstring date-time required

Changes

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