Skip to main content
POST
Onboard a creator
Required scope
  • write:creator — Modify creator profiles, settings, and creator-specific 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
email
string<email>
required

Email address for the new creator account

bankingCountry
string
required

Payout country of the creator (ISO 3166-1 alpha-2, e.g. GB)

Pattern: ^[A-Z]{2}$
subscriptionPrice
integer
required

Monthly subscription price in USD cents (399-10000)

Required range: 399 <= x <= 10000
password
string

Password for the new account (9-30 characters, at least one uppercase letter, one lowercase letter and one number). When omitted, an unguessable random password is generated; the creator can gain access via the standard password-reset flow.

Pattern: ^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).{9,30}$
handle
string

Fanvue handle for the new creator. When omitted, a unique handle is generated.

displayName
string

Display name for the new creator. Defaults to a name derived from the handle.

Required string length: 1 - 50
contentType
enum<string>
default:GENERAL

Content category for the new creator

Available options:
GENERAL,
NSFW
isAiCreator
boolean
default:false

Whether this is an AI creator

Response

Creator signup created with a pending verification session

uuid
string
required

UUID of the newly created creator

handle
string
required

Handle of the newly created creator

displayName
string
required

Display name of the newly created creator

email
string
required

Email address of the newly created creator

kycUrl
string | null
required

Hosted identity-verification URL. Give this link to the creator so they can complete KYC; verification is performed entirely by Fanvue's verification provider. Null when a verification session could not be started — the creator can still verify by logging in to Fanvue.