Messaging
List Conversations
List direct message conversations for a connected Instagram account.
List DM conversations for a connected Instagram Business or Creator account. Each conversation includes its participants and the most recent message, so you can build an inbox view.
Supported platforms: instagram
Note: Requires
instagram_business_manage_messages. Reconnect an existing account to grant newly approved permissions. More platforms will be added over time.
Request
GET /v1/messages
x-access-key: YOUR_ACCESS_KEYQuery parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
platform | string | Yes | instagram |
accountId | string | Yes | Integration ID from list_integrations |
limit | integer | No | Max conversations to return (1–100, default 20) |
after | string | No | Pagination cursor from a previous response |
Response
{
"success": true,
"selfId": "17841400000000000",
"selfUsername": "yourbrand",
"conversations": [
{
"id": "aWdfZG1fdGhyZWFkXzE",
"participants": [
{
"id": "17841400000000001",
"name": "Jane Doe",
"username": "jane_doe",
"profilePictureUrl": "https://scontent.cdninstagram.com/..."
},
{
"id": "17841400000000000",
"name": "Your Brand",
"username": "yourbrand",
"profilePictureUrl": null
}
],
"lastMessage": {
"id": "mid.aWdfbXNnXzk5OQ",
"text": "Do you ship internationally?",
"from": { "id": "17841400000000001", "name": "Jane Doe" },
"timestamp": "2026-08-05T16:40:00.000Z"
},
"updatedTime": "2026-08-05T16:40:00.000Z"
}
],
"nextCursor": "cursor_abc123"
}selfId is the connected account's own participant ID. To reply, use the participant id that is not selfId as the recipientId when you send a message.
Pass nextCursor as after in the next request to get the next page. null means no more pages.