POST
/
users

This endpoint creates a user, but it also facilitates signing an existing platform user up with the client brand in scenarios where the SSO flow wouldn’t be appropriate (i.e., the user is not signing in to an authenticated experience).

If a user with the specified email already exists, it signs the user up with the client brand before returning a 400 level error. This endpoint also returns authorization information for a successfully created user, including an access_token that can be used to access other API endpoints. Experiences utilizing this endpoint must adhere to the legal requirements for user creation.

Body

email
string
required

The user’s email

phone
string

The user’s phone number, formatted: +14157582345

first_name
string
required

The user’s first name

last_name
string
required

The user’s last name

birth_date
hash

The user’s birthday information

zip_code
string

The user’s zip code

This endpoint permits minimal requests that only contain an email parameter for the purposes of signing up an existing platform user with the client brand. If the email belongs to an existing user, it signs the user up with the brand before returning a 400 level error.

Response

user
User

The newly created user

authorization
Authorization

The authorization type of the created user