Messaging

List inboxes

Lists the account's personal inbox plus, when the company product is attached, one entry per company page and folder. Company inboxes are reply-only. company_id is null when the page can't be correlated to a managed page.

get/v1/{account_id}/inboxes

Request

Base URL: https://api.curviate.com
URL: https://api.curviate.com/v1/{account_id}/inboxes
Auth: HTTP bearer

Path parameters

account_idstring required

The account ID (acc_...) whose inboxes to list.

Query parameters

kind'personal' | 'company'

Filter to only personal (CLASSIC_) or only company (COMPANY_) inboxes. Omit to list both.

company_idstring

Filter to the one company inbox correlated to this managed-company id (e.g. '112013061').

Response

The account's inboxes: its own personal inbox, plus, when the company product is attached, one entry per company page (e.g. id='COMPANY_83734124_PRIMARY'). When no company inbox exists, hint names the Company Pages reconnect requirement instead of returning silently empty. This is the discovery step of the reply-as-a-page flow: find a company inbox here, read its conversations with GET /v1/{account_id}/inboxes/{inbox_id}/chats, then reply with the existing POST /v1/{account_id}/chats/{chat_id}/messages using one of its chat ids.

object'inbox_list'

Response type discriminator.

hintstring

Present only when no company inbox exists. Names the reconnect requirement.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

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