ProfilesAccountsConnectPostsMediaMessagesCommentsEngagementAutomationsAnalyticsFacebookTikTokPinterestBlueskyWebhooks

Messages

List Inbox Messages

Lists the messages in one conversation, newest first. Supported on Bluesky, Instagram and Facebook.

GET
/v1/inbox/conversations/{convoId}/messages

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.

Path Parameters

convoId*string
Length1 <= length

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

Messages

application/json
  1. response
accountId*string
convoId*string
messages*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.listInboxMessages({  convoId: "3k7x...",  accountId: "a1b2c3d4-e5f6-4a7b-8c9d-e0f1a2b3c4d5",  limit: 50,});console.log(response);
Example Response
{  "accountId": "a1b2c3d4-e5f6-4a7b-8c9d-e0f1a2b3c4d5",  "convoId": "3k7x...",  "messages": [    {      "id": "3k7y...",      "text": "Hey, loved your latest post!",      "senderId": "did:plc:alice",      "sentAt": "2026-09-08T12:00:00.000Z",      "attachments": [        {          "type": "image",          "url": "https://cdn.example.com/photo.jpg"        }      ]    }  ],  "cursor": "string"}

Create Inbox Conversation

Starts a one-to-one conversation on Bluesky, Instagram or Facebook. Identify the recipient by their username, user id, handle or DID on that platform.

Send Inbox Message

Sends a message to a conversation on Bluesky, Instagram or Facebook. Instagram and Facebook also support attachments, quick replies, buttons and carousels.