Messages

List Inbox Conversations

Lists inbox conversations for a connected account. Supported on Bluesky, Instagram and Facebook.

GET
/v1/inbox/conversations

Authorization

headerx-api-key<token>

Workspace API key, sent in the x-api-key header. Keys start with op_ and are created in the dashboard.

Query Parameters

accountId*string

Connection id.

Length1 <= length
limit?integer
Range1 <= value <= 100
cursor?string

Cursor from the previous response. Omit it to get the first page.

Length1 <= length

Response Body

Conversations

application/json
  1. response
accountId*string
convos*array<>
cursor*string|null
Example Request
import { Configuration, InboxApi } from "@onepostly/sdk";const inboxApi = new InboxApi(  new Configuration({ apiKey: process.env.ONEPOSTLY_API_KEY }));const response = await inboxApi.listInboxConversations({  accountId: "a1b2c3d4-e5f6-4a7b-8c9d-e0f1a2b3c4d5",  limit: 50,});console.log(response);
Example Response
{  "accountId": "a1b2c3d4-e5f6-4a7b-8c9d-e0f1a2b3c4d5",  "convos": [    {      "id": "3k7x...",      "members": [        {          "id": "did:plc:alice",          "username": "alice.bsky.social",          "displayName": "Alice"        }      ],      "muted": true,      "unreadCount": 2,      "lastMessage": {        "id": "3k7y...",        "text": "Hey!",        "sentAt": "2026-09-08T12:00:00.000Z"      }    }  ],  "cursor": "string"}