Messaging
Send Message
Send a direct message reply on Instagram.
Send a DM reply on a connected Instagram Business or Creator account.
Supported platforms: instagram
Note: Instagram (Meta) only allows sending within 24 hours of the recipient's last message. Outside that window the send is rejected by the platform. Sending a message costs 1 credit.
Request
POST /v1/messages
x-access-key: YOUR_ACCESS_KEY
Content-Type: application/jsonBody
| Field | Type | Required | Description |
|---|---|---|---|
platform | string | Yes | instagram |
accountId | string | Yes | Integration ID from list_integrations |
recipientId | string | Yes | The other participant's ID (from the conversation's participants) |
text | string | Yes | Message text (min length 1) |
{
"platform": "instagram",
"accountId": "6a8df8be8572dce3a2937c99",
"recipientId": "17841400000000001",
"text": "Hi! Yes, we ship worldwide. Here is the link to get started."
}Response
{
"success": true,
"messageId": "mid.aWdfbXNnXzEwMDA"
}To find the recipientId, read the conversation's participants and use the id that is not selfId (see List Conversations).