ReferenceAgencies

Send a mass message as creator

Send a message to multiple users based on selected lists as a creator. If `scheduledAt` (or alias `scheduled_at`) is provided, the message is queued for scheduled delivery instead of being sent immediately. <Info>Scopes required: `write:chat`, `read:creator`, `read:fan`</Info>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

Headers

X-Fanvue-API-VersionstringRequiredDefaults to 2025-06-26
API version to use for the request

Request

This endpoint expects an object.
includedListsobjectRequired
textstringOptional1-5000 characters
mediaUuidslist of stringsOptional
pricedouble or nullOptional>=300
excludedListsobjectOptional
scheduledAtstringOptionalformat: "date-time"

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

Response

Mass message sent successfully
idstringformat: "uuid"
recipientCountdouble
createdAtstring or nullformat: "date"

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
410
Gone Error