latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

Send a mass message

Send a message to multiple users based on selected lists.
If scheduledAt (or alias scheduled_at) is provided, the message is queued for scheduled delivery instead of being sent immediately.

post/chats/mass-messages

Headers

X-Fanvue-API-Versionstring required

Example:2025-06-26

API version to use for the request

Request body

textstring

mediaUuidsstring[]

mediaPreviewUuidstring uuid nullable

UUID of a single media item shown for free as a preview of a pay-to-view mass message. Requires a price and attached media.

pricenumber nullable

scheduledAtstring date-time

Optional scheduled date/time in ISO 8601 format. Alias scheduled_at is also accepted.

Response

Mass message sent successfully

uuidstring uuid required

UUID of the created mass message

publishedAtstring date nullable required

When the message was sent, or null when it is scheduled for later

recipientCountnumber required

Recipients resolved from the given lists at the time of this request. A scheduled message re-resolves its recipients at send time, so this is a preview and GET /chats/mass-messages reports 0 until it sends.