Send a message
Chats
Send a message
Send a message to a user in an existing chat conversation. The message can include text, media attachments, and optional pricing for pay-to-view content.
POST
Send a message
Required scope
write:chat— Create new chats and send messages. This scope is required for any chat-related actions that modify data.
Authorizations
OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.
Headers
API version to use for the request
Example:
"2025-06-26"
Path Parameters
Body
application/json
Required string length:
1 - 5000UUID of a single media item shown for free as a preview of a pay-to-view message. Requires a price and attached media (or a template).
Required range:
x >= 300Response
Message sent successfully