List user inboxes

GET

/domains/{domain}/users/{user}/inboxes

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

OperationId:ListInboxesUser

Returns every inbox a user is a member of: shared and main-number inboxes, the user's own personal inbox, and personal inboxes other users have shared with them. Use it to build an inbox list for that user.

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.

A personal inbox returns one row per phone number: did is the number, and user and owner are the owner. space_id identifies each inbox's conversations, and stays unique when an extension is reused. 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. A user with no inboxes returns an empty array.

Any user can list their own inboxes. Office Manager, Reseller, or Super User scope can list any user's in the domain. Site Manager and Call Center Supervisor scopes can list the inboxes of users in their own site. Other callers get 403.

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//users//inboxes?include_deactivated=yes' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Shared and personal inboxes

[
    {
        "name": "Support Line",
        "user": "5000@example.com",
        "owner": "1001@example.com",
        "inbox_kind": "shared",
        "space_id": "!aBcDeFgHiJkLmNoPqR:example.com",
        "did": null,
        "deactivated": false
    },
    {
        "name": "Reception",
        "user": "1001@example.com",
        "owner": "1001@example.com",
        "inbox_kind": "personal",
        "space_id": "!sTuVwXyZaBcDeFgHiJ:example.com",
        "did": "15555550100",
        "deactivated": false
    }
]

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

Read inbox

Create inbox