Read inbox

GET

/domains/{domain}/inboxes/{extension}

Last modified:2026-10-09 00:56:25

OperationId:GetSingleInbox

Returns one shared or main-number inbox. A user's extension returns 404: a personal inbox is read with GET /domains/{domain}/users/{user}/inboxes. A deleted inbox returns 404.

inbox_kind is one of these values:

shared: an inbox you create, with its own extension, one owner, and the members you add.

main_number: an inbox you create, with its own extension and no owner.

personal: the inbox every user already has, holding their SMS conversations across all their phone numbers (DIDs). It is addressed by the user's own extension and is never created or deleted here.

Requires Office Manager, Reseller, or Super User scope. A Site Manager reaches only the inboxes whose owner is a user in its own site. An inbox with no owner, or whose owner cannot be read, is out of its reach. Other scopes get 403. For a Site Manager, an inbox out of its reach returns 404.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200OK

application/json

The inbox.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//inboxes/5000' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Shared inbox

{
    "name": "Support Line",
    "user": "5000@example.com",
    "owner": "1001@example.com",
    "inbox_kind": "shared",
    "deactivated": false
}

Modified at 2026-10-09 00:56:25

List inboxes

List user inboxes