Skip to main content
POST
/
api
/
v2.1
/
customer
/
organization
/
registration
cURL
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/customer/organization/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 '
{
  "email": "admin@acmecorp-20260331115443-27f5ae.com",
  "password": "SecurePass123!",
  "matchingPassword": "SecurePass123!",
  "roleIds": [
    "ACCOUNT_OWNER",
    "ADMIN"
  ],
  "customerCategory": {
    "id": "fs-cat-b2b-small-001",
    "name": "Small Business"
  },
  "organizationCustomer": {
    "customerName": "My Company",
    "organization": {
      "legalName": "My Company Ltd.",
      "tradingName": "My Company",
      "registrationNumber": "REG-20260331115443",
      "taxId": "TAX-20260331115443"
    }
  }
}
'

​
Organization Registration

Creates an organization customer and initial admin user.

​
Endpoint

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

​
Key Defaults (from B2B runner)

  • Passwords: SecurePass123!
  • Category example: fs-cat-b2b-small-001 (Small Business)
  • Legal form: LIMITED_LIABILITY_COMPANY
  • Industry: TECHNOLOGY

​
Required Headers

​
Request Example

{
  "email": "admin@acmecorp-20260331115443-27f5ae.com",
  "password": "SecurePass123!",
  "matchingPassword": "SecurePass123!",
  "roleIds": ["ACCOUNT_OWNER", "ADMIN"],
  "customerCategory": {
    "id": "fs-cat-b2b-small-001",
    "name": "Small Business"
  },
  "organizationCustomer": {
    "customerName": "My Company",
    "organization": {
      "legalName": "My Company Ltd.",
      "tradingName": "My Company",
      "registrationNumber": "REG-20260331115443",
      "taxId": "TAX-20260331115443"
    }
  }
}

​
Response Example

200
{
  "code": 200,
  "data": {
    "organizationId": "f458d016-56bb-43a6-856c-4d0456b2c38c",
    "customerId": "f458d016-56bb-43a6-856c-4d0456b2c38c",
    "email": "admin@acmecorp-20260331115443-27f5ae.com"
  },
  "message": "Organization registered successfully. Default admin will be created automatically."
}
Used in B2B step runner Step 3 and mirrored in organization-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
​
email
string
required
Example:

"admin@acmecorp-20260331115443-27f5ae.com"

​
password
string
required
Example:

"SecurePass123!"

​
matchingPassword
string
required
Example:

"SecurePass123!"

​
roleIds
string[]
required
Example:
["ACCOUNT_OWNER", "ADMIN"]
​
customerCategory
object
required
​
organizationCustomer
object
required

Response

200

Registered