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, or a single third-party GIF (gif) in place of text and media.

A message whose mediaUuids carry audio media is delivered as a voice note. Upload the audio through POST /media/uploads first and wait for status: "ready".

post/chats/{userUuid}/message

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/chats/{userUuid}/message
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: write:chat

Path parameters

userUuidstring uuid required

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Request body

textstring nullable
mediaUuidsstring[]
mediaPreviewUuidstring uuid nullable

UUID 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).

pricenumber nullable
templateUuidstring uuid nullable

Response

Message sent successfully

messageUuidstring uuid required

Changes

No recorded changes to this operation across all 8 revisions of this API.