# Crear una organización hija (socio)

> Endpoint POST /organizations de la API de Proteside: parámetros, cuerpo de la solicitud, respuestas y ejemplos de código.

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

## Método y ruta

`POST /organizations`

Crea una organización con `parent_org_id` = tu organización. El propietario recibe un correo de invitación (tolerante a fallos: consulta `owner_invite`). Se crean las políticas de aprobación predeterminadas. Solo se permite un nivel de anidamiento.

## Parámetros

- `Idempotency-Key` (header, `string`): Reproduce la respuesta original durante 24 h

## Cuerpo de la solicitud

- `name` (`string`), obligatorio
- `owner_email` (`string`), obligatorio
- `plan` (`"essential" | "business_50k" | "business_100k" | "business_150k" | "business_200k" | "business_250k" | "business_300k" | "business_400k" | "business_500k" | "enterprise"`): Plan de la organización hija. `essential` es el plan Store (una tienda, 20.000 páginas vistas de checkout al mes, 7 días de historial, sin informes PCI). `business_<n>k` son los niveles de Business por páginas vistas de checkout mensuales, de 50.000 a 500.000 (dominios y usuarios ilimitados, 90 días de historial, informes PCI). `enterprise` tiene límites a medida. Los planes heredados anteriores a octubre de 2026 (`standard`, `growth`, `pro`) ya no se aceptan aquí.
- `billing_mode` (`"partner" | "stripe"`)

## Respuestas

- `201`: Creada
- `400`: Error de validación
- `401`: Token ausente / no válido / vencido
- `403`: El token no tiene el alcance
- `429`: Límite de solicitudes excedido

Especificación OpenAPI completa: https://app.proteside.com/api/v1/openapi.json
