---
title: "Onboard a creator"
method: POST
path: "/onboarding/creators"
---

# Onboard a creator

`POST /onboarding/creators`

Create a pre-filled Fanvue creator signup from the supplied details.

The account is provisioned with the given banking country, content category and subscription price already completed, and a pending identity-verification (KYC) session is started for it. The response includes `kycUrl`, the hosted verification link: give it to the creator so they can complete verification. Verification is performed entirely by Fanvue's verification provider — this API only initiates the session and never sees or influences the verification itself. A verification email is sent to the creator's address as part of signup.

The account is not yet an active creator: it becomes active once the creator passes verification and completes profile setup in the standard Fanvue onboarding flow (which is also where they land on first login if the link is lost).

<Info>Access is limited to approved partner applications. Contact Fanvue to have your application enabled for creator onboarding. Requests are additionally capped per application per day.</Info>

## Headers

- `X-Fanvue-API-Version` string, required

## Request body

- object
  - `email` string, email, required — Email address for the new creator account
  - `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.
  - `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.
  - `bankingCountry` string, required — Payout country of the creator (ISO 3166-1 alpha-2, e.g. GB)
  - `contentType` 'GENERAL' | 'NSFW' — Content category for the new creator
  - `isAiCreator` boolean — Whether this is an AI creator
  - `subscriptionPrice` integer, required — Monthly subscription price in USD cents (399-10000)

## Response `201`

Creator signup created with a pending verification session

- object
  - `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, nullable, 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.

## Other responses

- `400` — Bad Request - API version not supported OR validation failed
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded

---

[API](https://skmtc.net/fanvue/apis/fanvue-api.md) · [All operations](https://skmtc.net/fanvue/apis/fanvue-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanvue/fanvue-api/revisions/c5ddcd5c7e72/schema)