# Criar uma organização filha (parceiro)

> Endpoint POST /organizations da API do Proteside: parâmetros, corpo da requisição, respostas e exemplos de código.

URL: https://docs.proteside.com/pt-BR/docs/api/reference/organizations/createOrganization

## Método e rota

`POST /organizations`

Cria uma organização com `parent_org_id` = a sua organização. O proprietário recebe um e-mail de convite (tolerante a falhas: veja `owner_invite`). As políticas de aprovação padrão são criadas. Só é permitido um nível de aninhamento.

## Parâmetros

- `Idempotency-Key` (header, `string`): Reproduz a resposta original por 24 h

## Corpo da requisição

- `name` (`string`), obrigatório
- `owner_email` (`string`), obrigatório
- `plan` (`"essential" | "business_50k" | "business_100k" | "business_150k" | "business_200k" | "business_250k" | "business_300k" | "business_400k" | "business_500k" | "enterprise"`): Plano da organização filha. `essential` é o plano Store (uma loja, 20.000 pageviews de checkout por mês, 7 dias de histórico, sem relatórios PCI). `business_<n>k` são as faixas do Business por pageviews mensais de checkout, de 50.000 a 500.000 (domínios e usuários ilimitados, 90 dias de histórico, relatórios PCI). `enterprise` tem limites sob medida. Os planos legados anteriores a outubro de 2026 (`standard`, `growth`, `pro`) não são mais aceitos aqui.
- `billing_mode` (`"partner" | "stripe"`)

## Respostas

- `201`: Criada
- `400`: Erro de validação
- `401`: Token ausente / inválido / expirado
- `403`: O token não tem o escopo
- `429`: Limite de requisições excedido

Especificação OpenAPI completa: https://app.proteside.com/api/v1/openapi.json
