POST
/
messages
/
:platform

Send a new direct message to a recipient.

  • 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

Authorization
string
required
Format: Authorization: Bearer API_KEY. See API overview for more information.
Profile-Key
string
Profile Key of a user profile.

Path Parameters

platform
string
required

The platform to send the message: facebook, instagram, twitter

Request Body

recipientId
string
required

The ID of the message recipient.

message
string
required

The message to send to the recipient.

mediaUrls
array
required

Array of media URLS. Used for images and videos.

URLs of media items should end in the file extension without additional parameters appended.

Facebook and Instagram support multiple media URLs. Twitter only accepts a single media URL.