> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# suborganization.created

> Disparado quando uma sub-organização é criada e vinculada à plataforma.

## Evento `suborganization.created`

Disparado para a organização da plataforma quando uma nova sub-organização é vinculada — hoje pela conclusão de um [`hosted_flow`](https://scaleup-c34c4386.mintlify.site/api-reference/hosted-flows/create), e no futuro por outros caminhos (API direta, criação manual).

> [!NOTE]
>
> Quando a origem é um hosted flow, [`hosted_flow.completed`](https://scaleup-c34c4386.mintlify.site/api-reference/webhooks/hosted_flow.completed) também é disparado para o mesmo flow. A ordem de entrega entre os dois não é garantida — workers de retry podem inverter. Cada evento é idempotente pelo seu `id`.

## Payload de Exemplo

```json theme={null}
{
  "type": "suborganization.created",
  "id": "evt_3KLm9XPq",
  "timestamp": "2026-04-28T13:42:11.000Z",
  "data": {
    "suborganization": {
      "id": "org_seller_new",
      "name": "Acme Importadora LTDA"
    },
    "parent_organization_id": "org_platform_owner",
    "platform_id": "plat_abc",
    "onboarded_via": "hosted_flow",
    "platform_reference": {
      "external_reference": "airbee_seller_456",
      "metadata": {
        "airbee_workspace_id": "ws_789"
      }
    }
  }
}
```

## Campos do Payload

| Campo | Tipo | Descrição |
| - | - | - |
| `type` | `string` | `"suborganization.created"` |
| `id` | `string` | ID único do evento (`evt_*`). |
| `timestamp` | `string` | Data/hora ISO 8601. |
| `data.suborganization.id` | `string` | ID da sub-organização criada (`org_*`). |
| `data.suborganization.name` | `string` | Nome da sub-organização. |
| `data.parent_organization_id` | `string` | ID da organização da plataforma (destino do webhook). |
| `data.platform_id` | `string` | ID da plataforma. |
| `data.onboarded_via` | `string` | Origem do vínculo: `"hosted_flow"`, `"manual"` ou `"api"`. |
| `data.platform_reference` | `object` | Presente quando você passou `external_reference` e/ou `metadata` na criação do flow. Echo dos valores. |

## Uso Típico

```typescript theme={null}
switch (event.type) {
  case 'suborganization.created': {
    const { suborganization, platform_reference } = event.data
    await db.subOrgs.upsert({
      id: suborganization.id,
      name: suborganization.name,
      airbee_seller_id: platform_reference?.external_reference ?? null,
      airbee_metadata: platform_reference?.metadata ?? {},
    })
    break
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.