Proteside Docs
Referencia de endpointsOrganizaciones

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.

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

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í.

Predeterminado"business_100k"
Valor en"essential""business_50k""business_100k""business_150k""business_200k""business_250k""business_300k""business_400k""business_500k""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

essential (Store), business_50k … business_500k (niveles de Business), enterprise, o un plan heredado (standard, growth, pro) en organizaciones creadas antes de octubre de 2026.

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": "business_100k"  }'
{  "id": "7f3c1e2a-0b4d-4c8e-9f10-2a3b4c5d6e7f",  "name": "Loja do João",  "plan": "business_100k",  "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"}