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"
    }
  }
}
'
import requests

url = "https://sandbox.finhub.cloud/api/v2.1/customer/organization/registration"

payload = {
    "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"
        }
    }
}
headers = {
    "X-Forwarded-For": "<x-forwarded-for>",
    "X-Tenant-ID": "<x-tenant-id>",
    "X-Forwarded-From": "<x-forwarded-from>",
    "platform": "<platform>",
    "deviceId": "<deviceid>",
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {
    'X-Forwarded-For': '<x-forwarded-for>',
    'X-Tenant-ID': '<x-tenant-id>',
    'X-Forwarded-From': '<x-forwarded-from>',
    platform: '<platform>',
    deviceId: '<deviceid>',
    Authorization: '<authorization>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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'
      }
    }
  })
};

fetch('https://sandbox.finhub.cloud/api/v2.1/customer/organization/registration', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox.finhub.cloud/api/v2.1/customer/organization/registration",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json",
    "X-Forwarded-For: <x-forwarded-for>",
    "X-Forwarded-From: <x-forwarded-from>",
    "X-Tenant-ID: <x-tenant-id>",
    "deviceId: <deviceid>",
    "platform: <platform>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.finhub.cloud/api/v2.1/customer/organization/registration"

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

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Forwarded-For", "<x-forwarded-for>")
	req.Header.Add("X-Tenant-ID", "<x-tenant-id>")
	req.Header.Add("X-Forwarded-From", "<x-forwarded-from>")
	req.Header.Add("platform", "<platform>")
	req.Header.Add("deviceId", "<deviceid>")
	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://sandbox.finhub.cloud/api/v2.1/customer/organization/registration")
  .header("X-Forwarded-For", "<x-forwarded-for>")
  .header("X-Tenant-ID", "<x-tenant-id>")
  .header("X-Forwarded-From", "<x-forwarded-from>")
  .header("platform", "<platform>")
  .header("deviceId", "<deviceid>")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"admin@acmecorp-20260331115443-27f5ae.com\",\n  \"password\": \"SecurePass123!\",\n  \"matchingPassword\": \"SecurePass123!\",\n  \"roleIds\": [\n    \"ACCOUNT_OWNER\",\n    \"ADMIN\"\n  ],\n  \"customerCategory\": {\n    \"id\": \"fs-cat-b2b-small-001\",\n    \"name\": \"Small Business\"\n  },\n  \"organizationCustomer\": {\n    \"customerName\": \"My Company\",\n    \"organization\": {\n      \"legalName\": \"My Company Ltd.\",\n      \"tradingName\": \"My Company\",\n      \"registrationNumber\": \"REG-20260331115443\",\n      \"taxId\": \"TAX-20260331115443\"\n    }\n  }\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://sandbox.finhub.cloud/api/v2.1/customer/organization/registration")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Forwarded-For"] = '<x-forwarded-for>'
request["X-Tenant-ID"] = '<x-tenant-id>'
request["X-Forwarded-From"] = '<x-forwarded-from>'
request["platform"] = '<platform>'
request["deviceId"] = '<deviceid>'
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"admin@acmecorp-20260331115443-27f5ae.com\",\n  \"password\": \"SecurePass123!\",\n  \"matchingPassword\": \"SecurePass123!\",\n  \"roleIds\": [\n    \"ACCOUNT_OWNER\",\n    \"ADMIN\"\n  ],\n  \"customerCategory\": {\n    \"id\": \"fs-cat-b2b-small-001\",\n    \"name\": \"Small Business\"\n  },\n  \"organizationCustomer\": {\n    \"customerName\": \"My Company\",\n    \"organization\": {\n      \"legalName\": \"My Company Ltd.\",\n      \"tradingName\": \"My Company\",\n      \"registrationNumber\": \"REG-20260331115443\",\n      \"taxId\": \"TAX-20260331115443\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

​
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