Evento organization.created

Evento `organization.created`

Disparado para a organização da plataforma quando uma nova organização conectada é criada e vinculada a ela por POST /v1/organizations. data.object carrega o estado completo da organização conectada: identidade, dados fiscais, perfil público, endereço de cobrança, status de ativação financeira e conta para saques default quando preenchida. Use esse estado para criar o registro local sem chamadas extras à API.

O envelope do webhook sempre traz organization com a organização conectada que originou o evento. Para eventos de plataforma, esse valor é a organização conectada, não a plataforma.

Este evento só é enviado quando uma organização é criada de fato. Se a plataforma repetir POST /v1/organizations com o mesmo documento e a API devolver a organização existente, não haverá outro organization.created.

Quando acontece

Situação	Como aparece no payload
A plataforma criou uma nova organização conectada	`data.object.id` e o envelope `organization` apontam para a nova `org_*`.
A organização já nasce vinculada à plataforma	`data.object.platform` traz o `plat_*` da plataforma.
O status financeiro inicial foi definido	`activation_status` vem preenchido conforme o estado atual da organização.
Uma conta para saques default já existe	`payout_account` vem com os dados públicos da conta; caso contrário, vem `null`.

Como processar

Registre o id do evento (evt_*) para processar o webhook de forma idempotente.
Use data.object.id (org_*) como chave da organização conectada no seu sistema.
Salve o estado completo de data.object; campos ausentes no cadastro aparecem como null, {} ou [].
Use activation_status para decidir se a organização já pode receber pagamentos ou se ainda precisa concluir análise.
Use payout_account.account_number_last4, bank_name e holder_name para exibir a conta cadastrada sem expor número completo.
Use metadata para correlacionar a organização com seu cadastro interno quando você enviou metadata na criação.

Salve data.object.id uma única vez. Para reler a organização, chame GET /v1/organizations/{id} com a API key de plataforma e sem o header Organization.

Campos importantes

Campo	O que observar
`data.object.id`	ID público da organização conectada criada.
`activation_status`	Status financeiro atual da organização conectada.
`activation_status_updated_at`	Quando o status financeiro foi atualizado pela última vez.
`requirements`	Lista de tarefas da ativação: o que falta, o que está em análise.
`payout_account`	Conta para saques ativa, quando já houver uma conectada.
`document` / `document_type`	Documento fiscal da organização conectada.
`billing_address` / `billing_name`	Dados de cobrança usados em invoices e páginas hospedadas.
`branding_settings`	Identidade visual de invoices e do portal do cliente.
`platform`	ID da plataforma à qual a organização foi vinculada.
`metadata`	Ecoa os metadados enviados na criação da organização.

Status financeiros

Valor	Descrição
`not_submitted`	O cadastro financeiro ainda não foi enviado para análise.
`in_review`	Cadastro enviado e em análise.
`active`	Perfil financeiro aprovado e apto a receber pagamentos.
`disabled`	O perfil financeiro atual não está apto. Veja `requirements`.

Exemplo de payload

{
  "id": "evt_n95qyWCWA82crenr",
  "object": "event",
  "created_at": "2026-04-28T13:42:11.000Z",
  "data": {
    "object": {
      "id": "org_otfzVDHFF5Vio73J",
      "object": "organization",
      "activation_status": "active",
      "activation_status_updated_at": "2026-04-28T13:42:11.000Z",
      "activation_submitted_at": "2026-04-28T13:40:00.000Z",
      "avatar_url": "https://cdn.meusite.com/avatar.png",
      "billing_additional_info": "Inscrição municipal 123456",
      "billing_address": {
        "city": "São Paulo",
        "country": "BR",
        "line1": "Av. Paulista, 1000",
        "line2": "Conjunto 101",
        "postal_code": "01310-100",
        "state": "SP"
      },
      "billing_name": "Loja Exemplo Ltda",
      "branding_settings": {
        "accent_color": "#FF6B00",
        "border_style": "rounded",
        "brand_color": "#1B1B1B",
        "font_family": "system",
        "theme": "light"
      },
      "business_profile": {
        "annual_revenue": {
          "amount": 50000000,
          "currency": "brl"
        },
        "mcc": "5734",
        "url": "https://meusite.com"
      },
      "company": {
        "address": {
          "city": "São Paulo",
          "country": "BR",
          "line1": "Av. Paulista, 1000",
          "line2": "Conjunto 101",
          "postal_code": "01310-100",
          "state": "SP"
        },
        "email": "contato@meusite.com",
        "name": "Loja Exemplo Ltda",
        "opening_date": "2018-03-10",
        "phone": "+5511999990000",
        "trade_name": "Loja Exemplo"
      },
      "created_at": "2026-04-28T13:42:10.000Z",
      "dashboard_settings": {
        "timezone": "America/Sao_Paulo"
      },
      "document": "12345678000190",
      "document_type": "cnpj",
      "email": "contato@meusite.com",
      "individual": null,
      "livemode": true,
      "metadata": {},
      "name": "Loja Exemplo Ltda",
      "payout_account": {
        "id": "pa_Fb5AM4omTATT2bKZ",
        "object": "payout_account",
        "account_number_last4": "5678",
        "bank_code": "001",
        "bank_name": "Banco Exemplo S.A.",
        "created_at": "2026-04-28T13:40:00.000Z",
        "holder_name": "Loja Exemplo Ltda",
        "is_active": true,
        "is_verified": false,
        "livemode": true,
        "metadata": {},
        "routing_number": "0001",
        "type": "checking",
        "updated_at": "2026-04-28T13:42:11.000Z"
      },
      "platform": "plat_EJEfPv32XujjiJbu",
      "representative": {
        "address": {
          "city": "São Paulo",
          "country": "BR",
          "line1": "Av. Paulista, 1000",
          "line2": null,
          "postal_code": "01310-100",
          "state": "SP"
        },
        "birthdate": "1988-02-20",
        "document": "98765432100",
        "email": "carlos@meusite.com",
        "first_name": "Carlos",
        "last_name": "Pereira",
        "phone": "+5511988887777"
      },
      "requirements": {
        "disabled_reason": null,
        "errors": [],
        "missing": [],
        "pending_verification": []
      },
      "socials": [
        {
          "platform": "instagram",
          "url": "https://instagram.com/meusite"
        }
      ],
      "statement_descriptor": "LOJA EXEMPLO LTDA",
      "terms_acceptance": {
        "accepted_at": "2026-04-28T13:40:00.000Z",
        "ip": "203.0.113.10",
        "user_agent": "Mozilla/5.0"
      },
      "updated_at": "2026-04-28T13:42:11.000Z",
      "website": "https://meusite.com"
    }
  },
  "livemode": true,
  "organization": "org_otfzVDHFF5Vio73J",
  "request": {
    "id": "req_LYtJQd5jhArhTTvw"
  },
  "type": "organization.created"
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Evento organization.created