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
​
email
string
required

The email address.

Maximum length: 255
​
country
string
required

The country of residency.

​
citizenshipCountry
string
required

The citizenship country of the user.

​
termsOfService
enum<string>
required

The general terms of service the user agreed to.

Available options:
general-usrow,
general-ca-osc,
general-gb-fca,
general-lt-fcs
​
subdivision
string

The subdivision of residency.

Response

201
application/json
User created.
​
user
object
required