POST
/
core
/
users
curl --request POST \
  --url https://api.enterprise.sandbox.uphold.com/core/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Uphold-User-Ip: <x-uphold-user-ip>' \
  --data '{
  "email": "[email protected]",
  "termsOfService": "general-gb-fca",
  "country": "GB",
  "subdivision": "GB-MAN",
  "citizenshipCountry": "GB"
}'
{
  "user": {
    "id": "cd21b26d-35d2-408a-9201-b8fdbef7a604",
    "email": "[email protected]",
    "citizenshipCountry": "GB",
    "address": {
      "country": "GB",
      "subdivision": "GB-MAN"
    },
    "createdAt": "2024-03-13T20:20:39+00:00",
    "updatedAt": "2024-03-13T20:20:39+00:00"
  }
}

Users must read and agree with the general Terms of Service associated with their country of residence, and you must provide it in the termsOfService field of the request.

You can find details on countries and subdivisions here.

Furthermore, the X-Uphold-User-Ip header is mandatory on this request, so that the user’s IP gets recorded when accepting the general Terms of Service.

Authorizations

​
Authorization
string
header
required

OAuth 2.0 authentication.

Headers

​
X-Uphold-User-Ip
required

Contains the IP of the end user that is requesting the operation.

Body

application/json

Response

201
application/json

User created.

The response is of type object.