Skip to main content
POST
/
api
/
v2.1
/
customer
/
individual
/
registration
cURL
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/customer/individual/registration \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'X-Forwarded-For: <x-forwarded-for>' \
  --header 'X-Forwarded-From: <x-forwarded-from>' \
  --header 'X-Tenant-ID: <x-tenant-id>' \
  --header 'deviceId: <deviceid>' \
  --header 'platform: <platform>' \
  --data '
{
  "firstName": "John",
  "lastName": "Customer",
  "email": "customer.20260331114946-387074@testcorp.com",
  "phone": "+37062767557",
  "password": "SecurePass123!",
  "matchingPassword": "SecurePass123!",
  "dateOfBirth": "1990-05-15",
  "gender": "MALE",
  "nationality": "Lithuania",
  "placeOfBirth": "Vilnius",
  "pincode": "12345",
  "roleIds": [
    "ACCOUNT_OWNER",
    "USER"
  ],
  "customerCategory": {
    "id": "fs-cat-b2c-low-001",
    "name": "Individual Standard"
  },
  "individualCustomer": {
    "customerName": "John Customer",
    "tenantId": "97e7ff29-15f3-49ef-9681-3bbfcce4f6cd"
  }
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.finhub.cloud/llms.txt

Use this file to discover all available pages before exploring further.

​
Individual Registration

Creates an individual customer, linked person, and initial user in PENDING_ACTIVATION.

​
Endpoint

POST /api/v2.1/customer/individual/registration

​
Key Defaults (from B2C runner)

  • password and matchingPassword: SecurePass123!
  • Category example: fs-cat-b2c-low-001 (Individual Standard)
  • Role IDs: ACCOUNT_OWNER, USER

​
Required Headers

​
Example Request

{
  "firstName": "John",
  "lastName": "Customer",
  "email": "customer.20260331114946-387074@testcorp.com",
  "phone": "+37062767557",
  "password": "SecurePass123!",
  "matchingPassword": "SecurePass123!",
  "dateOfBirth": "1990-05-15",
  "gender": "MALE",
  "nationality": "Lithuania",
  "placeOfBirth": "Vilnius",
  "pincode": "12345",
  "roleIds": ["ACCOUNT_OWNER", "USER"],
  "customerCategory": {
    "id": "fs-cat-b2c-low-001",
    "name": "Individual Standard"
  }
}

​
cURL

curl -X POST "https://sandbox.finhub.cloud/api/v2.1/customer/individual/registration" \
  -H "Content-Type: application/json" \
  -H "X-Tenant-ID: 97e7ff29-15f3-49ef-9681-3bbfcce4f6cd" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -d @registration.json

​
Success Response

200
{
  "code": 200,
  "data": {
    "id": "2dac1793-ab48-420c-b0b5-01292302e188",
    "customerStatus": "CS_REGISTRATION_COMPLETED",
    "user": {
      "id": "0d488f57-57ef-4f9a-88a6-f89121cab838",
      "email": "customer.20260331114946-387074@testcorp.com"
    }
  },
  "message": "B2C individual account created successfully"
}
Used in B2C step runner Step 3 and mirrored in individual-playground.crx.js.

Headers

​
X-Forwarded-For
string
required
​
X-Tenant-ID
string
required
​
X-Forwarded-From
string
required
​
platform
string
required
​
deviceId
string
required
​
Authorization
string
required

Body

application/json
​
firstName
string
required
Example:

"John"

​
lastName
string
required
Example:

"Customer"

​
email
string
required
Example:

"customer.20260331114946-387074@testcorp.com"

​
phone
string
required
Example:

"+37062767557"

​
password
string
required
Example:

"SecurePass123!"

​
matchingPassword
string
required
Example:

"SecurePass123!"

​
dateOfBirth
string
required
Example:

"1990-05-15"

​
gender
string
required
Example:

"MALE"

​
nationality
string
required
Example:

"Lithuania"

​
placeOfBirth
string
required
Example:

"Vilnius"

​
pincode
string
required
Example:

"12345"

​
roleIds
string[]
required
Example:
["ACCOUNT_OWNER", "USER"]
​
customerCategory
object
required
​
individualCustomer
object
required

Response

200

Registered