Skip to main content

​
Evento suborganization.created

Disparado para a organização pai quando uma nova suborganização é criada através do SDK (ex: chargefy.subOrganizations.create()).
O campo data.parent_organization_id identifica qual organização pai receberá este webhook — útil caso sua conta tenha múltiplas relações pai-filho.

​
Payload de Exemplo

{
  "type": "suborganization.created",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": "2026-03-18T12:00:00.000Z",
  "data": {
    "suborganization": {
      "id": "org_child_abc123",
      "name": "Suborg LTDA",
      "slug": "suborg-ltda",
      "status": "created"
    },
    "parent_organization_id": "org_parent_xyz"
  }
}

​
Campos do Payload

CampoTipoDescrição
typestring"suborganization.created"
idstringUUID único do evento (igual ao header webhook-id)
timestampstringData/hora ISO 8601 do evento
data.suborganization.idstringID da suborganização criada
data.suborganization.namestringNome da suborganização
data.suborganization.slugstringSlug único da suborganização
data.suborganization.statusstringStatus inicial ("created")
data.parent_organization_idstringID da organização pai que recebeu o webhook

​
Uso Típico

switch (event.type) {
  case 'suborganization.created':
    const { suborganization, parent_organization_id } = event.data;
    // Registrar a nova suborganização no seu banco de dados
    await db.subOrgs.upsert({
      id: suborganization.id,
      name: suborganization.name,
      parentOrgId: parent_organization_id,
    });
    break;
}