inboxes

Create an inbox

Creates a receiving address. The body is optional: with no body the inbox gets a random 10-character local part on the shared domain and no expiry. Creation draws on a second per-key bucket (burst 10, refills 10/minute) in addition to the general request budget — either can answer 429.

post/v1/inboxes

Request

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

Request body

domainstring

A shared domain or one of the account's verified custom domains. Omit for the shared domain.

local_partstring

Lowercased on input; must not start or end with a dot. Omit for a random 10-char local part.

ttl_secondsinteger

Auto-expire the inbox after this many seconds (max 30 days). Expired inboxes 550-reject new mail and are swept hourly. Omit for no expiry.

Response

Inbox created.

created_atstring date-time required
domainstring required
email_addressstring required

local_part@domain — the address to send to.

idstring uuid required
local_partstring required
ttl_expires_atstring date-time nullable required

Changes

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