curl --request POST \
--url https://production.hifibridge.com/v2/users \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "individual",
"firstName": "<string>",
"lastName": "<string>",
"email": "<string>",
"dateOfBirth": "2023-12-25",
"signedAgreementId": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"chains": [
"POLYGON"
],
"address": {
"addressLine1": "<string>",
"city": "<string>",
"stateProvinceRegion": "<string>",
"postalCode": "<string>",
"country": "<string>",
"addressLine2": "<string>"
},
"ipAddress": "127.0.0.1"
}
'{
"id": "4d93ab4f-3983-4ac0-8c97-54bbc0f287fa",
"createdAt": "2025-09-24T19:12:20.541Z",
"type": "individual",
"email": "[email protected]",
"name": "John Doe",
"wallets": {
"INDIVIDUAL": {
"ETHEREUM": {
"address": "0x43B343Bb48E23F58406271131B71448fF95787AD"
},
"POLYGON": {
"address": "0x43B343Bb48E23F58406271131B71448fF95787AD"
}
}
}
}Create a user
Create a new Hifi user (Individual/Business)
HIFI does not provide services to users or businesses from sanctioned and high-risk regions or unsupported US states. See here for supported regions.
curl --request POST \
--url https://production.hifibridge.com/v2/users \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "individual",
"firstName": "<string>",
"lastName": "<string>",
"email": "<string>",
"dateOfBirth": "2023-12-25",
"signedAgreementId": "<string>",
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"chains": [
"POLYGON"
],
"address": {
"addressLine1": "<string>",
"city": "<string>",
"stateProvinceRegion": "<string>",
"postalCode": "<string>",
"country": "<string>",
"addressLine2": "<string>"
},
"ipAddress": "127.0.0.1"
}
'{
"id": "4d93ab4f-3983-4ac0-8c97-54bbc0f287fa",
"createdAt": "2025-09-24T19:12:20.541Z",
"type": "individual",
"email": "[email protected]",
"name": "John Doe",
"wallets": {
"INDIVIDUAL": {
"ETHEREUM": {
"address": "0x43B343Bb48E23F58406271131B71448fF95787AD"
},
"POLYGON": {
"address": "0x43B343Bb48E23F58406271131B71448fF95787AD"
}
}
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
- Create Individual User
- Create Business User
individual Date of birth in format yyyy-mm-dd.
ID of the signed agreement, fetched through the HIFI's Hosted Terms of Service Link POST /tos-link
Request ID for user creation. If not provided, a random UUID will be generated. Using the same requestId will result in the same user being returned.
The chains to create wallets for, default to POLYGON and ETHEREUM.
POLYGON, ETHEREUM, SOLANA, BASE Address of the user.
Either the address or the ipAddress must be provided.
Show child attributes
Show child attributes
The second part of the ISO 3166-2 subdivision code. This must be provided if the country has subdivisions.
An ISO 3166-2 code consists of two parts, separated by a hyphen (-):
- The first part is the ISO 3166-1 alpha-2 code of the country (e.g.,
US,CA,BR); - The second part is a string of up to three alphanumeric characters representing a specific subdivision (e.g., state, province). This is typically based on national standards or developed by ISO.
Only provide the second part of the code (e.g., CA for California in US-CA, or SP for São Paulo in BR-SP).
Must be supplied for countries that use postal codes.
Three-letter alpha-3 country code as defined in the ISO 3166-1 spec.
IP address of the user.
Either the address or the ipAddress must be provided.
Response
Success
- User Object (Individual)
- User Object (Business)
User ID
Data and time when the user was created
Show child attributes
Show child attributes