Skip to main content
POST
/
messages
/
:platform
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"message": "What's up!", "recipientId": "283j839222"} \
-X POST https://api.ayrshare.com/api/messages/instagram

{ // single text message
    "status": "success",
    "recipientId": "72706337063589124",
    "messageId": "aWdfZAG1faXRlbToxOkl",
    "message": "What is up?"
}

Documentation Index

Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Send a new direct message to a recipient.
Pricing & Limits: Each User Profile can have up to 1,000 active conversations per billing cycle across all social networks. Pricing depends on your plan: Premium plans pay a flat 49permonth∗∗add−on,while∗∗Launch∗∗and∗∗Business∗∗plansarebilledat∗∗49 per month** add-on, while **Launch** and **Business** plans are billed at **0.09 per active conversation. A conversation is counted as active when you send a message to a recipient during the billing cycle; inbound messages alone do not count. The number of messages within an active conversation is unlimited.
  • You can send an emoji as part of the message text.
  • Facebook and Instagram mediaUrls must end in a known extension. Including query parameters will cause the media url to fail.

​
Header Parameters

​
Path Parameters

​
platform
string
required
The platform to send the message: facebook, instagram, twitter

​
Body Parameters

​
recipientId
string
required
The ID of the message recipient.
​
message
string
required
The message to send to the recipient.
  • Facebook and Instagram message may be an empty string or not included if a mediaUrls is provided.
  • X requires a message of at least one character even if a mediaUrls is provided.
​
mediaUrls
array
Array of media URLS for attaching images, a video, or a voice message.
  • URLs of media items should end in the file extension without additional parameters appended.
  • Facebook and Instagram support multiple media URLs.
  • X only accepts a single media URL.
  • Voice messages are supported on Facebook and Instagram as an aac or wav file.
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"message": "What's up!", "recipientId": "283j839222"} \
-X POST https://api.ayrshare.com/api/messages/instagram

{ // single text message
    "status": "success",
    "recipientId": "72706337063589124",
    "messageId": "aWdfZAG1faXRlbToxOkl",
    "message": "What is up?"
}