> ## 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.updated

> Disparado quando o status de ativação financeira de uma sub-organização muda.

## Evento `suborganization.updated`

Disparado para a organização da plataforma quando o status de ativação
financeira de uma sub-organização muda — por exemplo, quando o cadastro
sai de `pending` para `active` após aprovação, ou para `denied` após
recusa.

## Payload de Exemplo

```json theme={null}
{
  "type": "suborganization.updated",
  "id": "evt_3KLm9XPq",
  "timestamp": "2026-04-30T18:35:00.000Z",
  "data": {
    "suborganization": {
      "id": "org_seller_new",
      "name": "Acme Importadora LTDA"
    },
    "parent_organization_id": "org_platform_owner",
    "platform_id": "plat_abc",
    "seller_activation_status": "active",
    "previous_seller_activation_status": "pending",
    "platform_reference": {
      "external_reference": "airbee_seller_456",
      "metadata": {
        "airbee_workspace_id": "ws_789"
      }
    }
  }
}
```

## Campos do Payload

| Campo | Tipo | Descrição |
| - | - | - |
| `type` | `string` | `"suborganization.updated"` |
| `id` | `string` | ID único do evento (`evt_*`). |
| `timestamp` | `string` | Data/hora ISO 8601. |
| `data.suborganization.id` | `string` | ID da sub-organização (`org_*`). |
| `data.suborganization.name` | `string \| null` | Nome atual 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.seller_activation_status` | `string` | Status atual: `activation_pending`, `pending`, `active`, `denied`, `disabled`. |
| `data.previous_seller_activation_status` | `string` | Status imediatamente anterior — útil pra detectar transições (ex: `pending → active`). |
| `data.platform_reference` | `object` | Presente quando o vínculo carrega `external_reference` e/ou `metadata` da criação do flow. |

## Uso Típico

```typescript theme={null}
switch (event.type) {
  case 'suborganization.updated': {
    const { suborganization, seller_activation_status, previous_seller_activation_status } = event.data
    if (previous_seller_activation_status !== 'active' && seller_activation_status === 'active') {
      // Liberar a sub-org pra operar no seu sistema
      await db.subOrgs.update({
        id: suborganization.id,
        status: 'active',
        activated_at: new Date(),
      })
    }
    break
  }
}
```


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