URL: /baas/api/reference/customer-apis/organization/registration

---
title: 'Organization Registration'
description: 'Register a new B2B organization customer'
---

import { RequiredRunnerHeaders } from '../../schemas/required-headers-snippet.mdx';

# 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

<RequiredRunnerHeaders />

## Request Example

```json
{
  "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

```json 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."
}
```

<Note>
  Used in B2B step runner Step 3 and mirrored in `organization-playground.crx.js`.
</Note>