Skip to main content
POST
Create a template message
Required scope
  • write:chat β€” Create new chats and send messages. This scope is required for any chat-related actions that modify data.

Authorizations

Authorization
string
header
required

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

X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Body

application/json
folderUuid
string<uuid>
required

UUID of the folder to create the template in (see GET /chats/templates/folders)

text
string

Message text content

price

Message price in cents (0 or null for free messages)

Available options:
0
mediaUuids
string<uuid>[]

Media UUIDs to attach to the template, in display order

mediaPreviewUuid
string<uuid>

Media UUID to use as the paywall preview

name
string

Optional template name

Response

Template message created

uuid
string<uuid>
required

Template message UUID

text
string | null
required

Message text content

price
number | null
required

Message price in cents (null for free messages)

mediaUuids
string<uuid>[]
required

Array of media UUIDs attached to the message

mediaPreviewUuid
string<uuid> | null
required

Media UUID used as the paywall preview (null when the template has none)

folderUuid
string<uuid> | null
required

UUID of the folder containing this template

folderName
string | null
required

Name of the folder containing this template