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

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

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