POST/api/partner/users

Create a user

Creates a Prio account for one of your users and returns a signed-in session. Hand the session to the embed and your user picks up onboarding where your data leaves off.

Request body

Field Type Required
email string yes
phone string yes
firstName string or null when isIndividual
lastName string or null when isIndividual
displayName string or null when not isIndividual
legalName string or null no
isIndividual boolean yes
entityType string or null no
website string yes
defaultRole string yes
businessDescription string or null no
dob string or null no
taxId string or null no
averageTransactionSize number or null no
averageWeeklyTransactions number or null no
address <Address> or null no
street string yes
streetLine2 string or null no
city string yes
state string yes
postalCode string yes
country string yes
201 Created
{
  "success": true,
  "message": "User created successfully",
  "result": {
    "userId": "8f2c1d4e-6b7a-4c3d-9e1f-2a3b4c5d6e7f",
    "jwt": "eyJhbGciOi…",
    "refreshJwt": "eyJhbGciOi…",
    "referralToken": "maya-ortiz"
  }
}

An email or phone that is already a Prio account returns 409. The name you send fixes the user's referralToken — the handle a payment button names — for good.

Prio may display inaccurate info at times, please double check the responses.