Proteside Docs
Referencia de endpointsOrganizaciones

Crear una organización hija (socio)

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.

Autorización

bearerAuth
headerAutorizaciónBearer <token>

Token de API creado en Ajustes → API. Los alcances están vinculados al token; cada operación indica el alcance requerido en x-scope.

Parámetros de encabezado

Idempotency-Key?string

Reproduce la respuesta original durante 24 h

Longitud1 <= length <= 255

Cuerpo de la solicitud

application/json
  1. body
name*string
Longitud2 <= length <= 120
owner_email*string
Formatoemail
plan?string
Predeterminado"growth"
Valor en"essential""standard""growth""pro""enterprise"
billing_mode?string
Predeterminado"partner"
Valor en"partner""stripe"

Cuerpo de la respuesta

Creada

application/json
  1. response
id?string
Formatouuid
name?string
plan?string
billing_mode?string
Valor en"stripe""partner"
parent_org_id?|
Formatouuid
owner_email?|
Formatoemail
partner_settings?
created_at?string
Formatodate-time
owner_invite?string
Valor en"sent""existing_user""failed""skipped"
curl -X POST "https://example.com/organizations" \  -H "Content-Type: application/json" \  -d '{    "name": "Loja do João",    "owner_email": "joao@lojadojoao.com.br",    "plan": "growth"  }'
{  "id": "7f3c1e2a-0b4d-4c8e-9f10-2a3b4c5d6e7f",  "name": "Loja do João",  "plan": "growth",  "billing_mode": "partner",  "parent_org_id": "a1b2c3d4-0000-4000-8000-000000000001",  "owner_email": "joao@lojadojoao.com.br",  "partner_settings": {},  "created_at": "2026-09-27T10:00:00.000Z",  "owner_invite": "sent"}