Create User Account

Testing Env

https://partner-api-stage.p100.io

POST

/v1/user/balances/crypto-and-fiat

This endpoint creates a new user.

Each user must be uniquely identified using the externalUserId field. Attempts to reuse an existing ID will result in an error.

Once created, submit user documents using either Add KYC File or the KYC by P100 flow, and then finalize the process with the Add User Verification endpoint.

If the user is from a country that requires proof of address (POA), the response will include the field:

"poaRequiredForExtended": true

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/json

Examples

Responses

🟢201Created

application/json

Body

🟠401Access Denied

🟠400P403: Validation error

🟠400P411: User exists

🟠400P431: Forbidden country

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://partner-api-stage.p100.io/v1/user/balances/crypto-and-fiat' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "externalUserId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "email": "john.smith@example.com",
  "phone": "14155552671",
  "firstName": "John",
  "lastName": "Smith",
  "street": "Main Street",
  "number": "123",
  "city": "London",
  "postCode": "SW1A 1AA",
  "country": "GB",
  "citizenship": "GB",
  "nationality": "GB",
  "birthCountry": "GB",
  "birthDate": "1998-08-03"
}'

Response Example

201 - Success

{
    "userId": "f63064b1-c26b-4c9e-af22-0b483262751f",
    "poaRequiredForExtended": false
}

User Accounts

Add KYC File