List inboxes

GET

/domains/{domain}/inboxes

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

OperationId:ListInboxesDomain

Returns the shared and main-number inboxes in a domain, sorted by extension. Personal inboxes are not listed: read a user's inboxes with GET /domains/{domain}/users/{user}/inboxes.

An inbox is where SMS conversations are read and answered. A shared inbox has its own extension, and every member sees and answers its conversations.

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.

include_deactivated adds deleted inboxes, with deactivated: true. It accepts 1, true, or yes, and only Office Manager, Reseller, or Super User scope can use it: for other scopes it is ignored. owner and inbox_kind are null when they could not be read.

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, the list holds only those inboxes.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

The inboxes. An empty array when there are none.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🔴502Bad Gateway

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Inboxes

[
    {
        "name": "Support Line",
        "user": "5000@example.com",
        "owner": "1001@example.com",
        "inbox_kind": "shared",
        "deactivated": false
    },
    {
        "name": "Front Desk",
        "user": "5001@example.com",
        "owner": null,
        "inbox_kind": "main_number",
        "deactivated": false
    }
]

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

Deploy extension version

Read inbox