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, e no futuro por outros caminhos (API direta, criação manual).

Quando a origem é um hosted flow, 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

{
  "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

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
  }
}