Skip to main content
POST
Create a user
Create a person your company vouches for: you send their name, date of birth and an email or phone number, and no code goes to them. Use the id it returns as the user_id on every other endpoint. To have a person approve your app themselves, connect them instead. Cardholders you created with /api/v1/cardholders already work on v2: pass either their cardholder id or their user_id. Creating the same person again answers 409 user_exists with the person you already have, so a retry is safe.

Authorizations

Authorization
string
header
required

A platform access token. Get one on the Create an access token endpoint by exchanging your client_id + client_secret, then send it as Authorization: Bearer <token>. Tokens live one hour.

Body

application/json
first_name
string
required
last_name
string
required
date_of_birth
string
required

YYYY-MM-DD.

Example:

"1990-01-15"

email
string

Send an email, a phone number, or both.

phone_number
string

Send an email, a phone number, or both.

Response

The user.

object
string
required

Always user.

id
string
required

The user_id every other endpoint takes.

cardholder_id
string
required

The same person's id on /api/v1/cardholders. v2 endpoints take it as user_id too.

livemode
boolean
required

false for a person created with a sandbox credential.

created_at
string<date-time>
required
first_name
string | null
last_name
string | null
email
string | null
phone_number
string | null
date_of_birth
string | null

YYYY-MM-DD.