Inbox

Endpoints related to the unified inbox: chats that merge direct messages and post comments per participant.

List chats

get

Lists the current user's unified chats. Each chat merges a single participant's direct messages and post comments on one connected account, ordered by most recent activity. Supports cursor-based pagination and filtering by platform and account.

Authorizations

apiKey

blotato-api-keystringRequired

Query parameters

limitinteger · min: 1 · max: 250Optional

Maximum number of chats to return. Defaults to 50.

Default: 50

cursorstringOptional

Opaque cursor returned by a previous call. Pass it to fetch the next page.

Responses

200

Default Response

application/json

cursorstringOptional

Cursor for the next page. Absent when there are no more chats.

404

Not found

application/json

422

Validation error

application/json

500

Server error

application/json

get

/v2/inbox/chats

HTTPcURLJavaScriptPython

GET /v2/inbox/chats HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "id": "text",
      "platform": "bluesky",
      "accountId": "text",
      "participantId": "text",
      "lastActivityAt": "text",
      "lastItem": {
        "kind": "message",
        "text": "text",
        "createdAt": "text"
      }
    }
  ],
  "cursor": "text"
}

List chat items

get

Lists the merged timeline of direct messages and post comments for a single chat, ordered by creation time (most recent first). Supports cursor-based pagination.

Authorizations

apiKey

blotato-api-keystringRequired

Path parameters

chatIdstringRequired

Query parameters

limitinteger · min: 1 · max: 250Optional

Maximum number of chat items to return. Defaults to 50.

Default: 50

cursorstringOptional

Opaque cursor returned by a previous call. Pass it to fetch the next page.

Responses

200

Default Response

application/json

itemsone of[]Required

Merged list of messages and comments.

or

cursorstringOptional

Cursor for the next page. Absent when there are no more items.

404

Not found

application/json

422

Validation error

application/json

500

Server error

application/json

get

/v2/inbox/chats/{chatId}/items

HTTPcURLJavaScriptPython

GET /v2/inbox/chats/{chatId}/items HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "conversationId": "text",
      "createdAt": "text",
      "errorCode": 1,
      "errorMessage": "text",
      "id": "text",
      "platform": "bluesky",
      "recipientId": "text",
      "senderId": "text",
      "status": "delivered",
      "text": "text",
      "kind": "message",
      "direction": "inbound"
    }
  ],
  "cursor": "text"
}