Skip to main content
POST
Create a KYC profile

Body

application/json

Identity and optional reusable-verification data for the new profile.

email
string<email>
required

Email address of the person being onboarded.

external_reference
string

Stable identifier from your system. Used for reconciliation and idempotent creation retries.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9_-]+$
reuse_kyc
object

Optional data for reusing a supported identity verification. This feature must be enabled for the partner. When omitted, the user completes the standard identity-verification flow.

safe_owner_address
string

Optional Ethereum address that will own the user's funding wallet. Must be a valid 0x-prefixed, 40-hex-character address controlled by the user.

Response

The request has succeeded.

profile_id
string<uuid>
required

ID of the created profile, or the existing profile when the request is retried.