# Create a child organization (partner)

> POST /organizations endpoint of the Proteside API: parameters, request body, responses and code samples.

URL: https://docs.proteside.com/en/docs/api/reference/organizations/createOrganization

## Method and route

`POST /organizations`

Creates an organization with `parent_org_id` = your organization. The owner receives an invitation e-mail (tolerant to failure: see `owner_invite`). Default approval policies are seeded. Only one level of nesting is allowed.

## Parameters

- `Idempotency-Key` (header, `string`): Replays the original response for 24 h

## Request body

- `name` (`string`), required
- `owner_email` (`string`), required
- `plan` (`"essential" | "business_50k" | "business_100k" | "business_150k" | "business_200k" | "business_250k" | "business_300k" | "business_400k" | "business_500k" | "enterprise"`): Plan of the child organization. `essential` is the Store plan (one store, 20,000 checkout pageviews/month, 7 days of history, no PCI reports). `business_<n>k` are the Business tiers by monthly checkout pageviews, 50,000 to 500,000 (unlimited domains and users, 90 days of history, PCI reports). `enterprise` has custom limits. Legacy plans from before October 2026 (`standard`, `growth`, `pro`) are no longer accepted here.
- `billing_mode` (`"partner" | "stripe"`)

## Responses

- `201`: Created
- `400`: Validation error
- `401`: Missing / invalid / expired token
- `403`: Token lacks the scope
- `429`: Rate limit exceeded

Full OpenAPI specification: https://app.proteside.com/api/v1/openapi.json
