v55

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-051,2852,0364.4 MB

Email Inboxes

Create an email inbox

Creates an inbox on an inbound-enabled domain. When domain_id is omitted, Telnyx allocates the account's shared inbound subdomain so the inbox is immediately usable without customer DNS setup. When username is omitted, a unique username is generated.

post/email_inboxes

Request body

usernamestring

Inbox local part. Trimmed and lowercased before validation; the normalized value must be 1-64 characters, start and end with a letter or digit, and contain only letters, digits, dots, hyphens, and underscores. Generated when omitted.

domain_idstring uuid

Account-owned, inbound-enabled domain UUID. The account's shared inbound subdomain is allocated when omitted.

Response

Email inbox created.