> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Evento organization.created

> 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`](/api-reference/organizations/create).

`data.object` carrega o snapshot completo da organização conectada (identidade, dados fiscais, perfil público, endereço de cobrança, status de ativação financeira e conta bancária default quando preenchidos) para que você possa armazenar localmente sem chamadas extras à API.

## Exemplo de payload

```json theme={}
{
  "id": "evt_123",
  "object": "event",
  "created_at": "2026-04-28T13:42:11.000Z",
  "data": {
    "object": {
      "id": "org_789",
      "object": "organization",
      "activation_status": "activation_pending",
      "activation_status_updated_at": null,
      "avatar_url": "https://cdn.meusite.com/avatar.png",
      "bank_account": null,
      "billing_additional_info": null,
      "billing_address": null,
      "billing_name": null,
      "branding_settings": {
        "accent_color": null,
        "border_style": null,
        "brand_color": null,
        "font_family": null,
        "theme": null
      },
      "created_at": "2026-04-28T13:42:10.000Z",
      "document": "12345678000190",
      "document_type": "cnpj",
      "email": "contato@meusite.com",
      "livemode": true,
      "metadata": {},
      "name": "Acme Importadora",
      "platform": "plat_456",
      "socials": [
        {
          "platform": "instagram",
          "url": "https://instagram.com/meusite"
        }
      ],
      "updated_at": null,
      "website": "https://meusite.com"
    }
  },
  "livemode": true,
  "organization": "org_789",
  "request": {
    "id": null
  },
  "type": "organization.created"
}
```

## Campos do payload

### Payload

| Campo          | Tipo      | Descrição                                                                           |
| -------------- | --------- | ----------------------------------------------------------------------------------- |
| `id`           | `string`  | ID único do evento (`evt_*`).                                                       |
| `object`       | `string`  | Sempre `"event"`.                                                                   |
| `created_at`   | `string`  | Data/hora ISO 8601 da geração do evento.                                            |
| `livemode`     | `boolean` | Mesmo valor de `data.object.livemode`.                                              |
| `organization` | `string`  | ID da organização conectada que originou o evento. Mesmo valor de `data.object.id`. |
| `type`         | `string`  | `"organization.created"`                                                            |

### `data`

| Campo    | Tipo     | Descrição                                                    |
| -------- | -------- | ------------------------------------------------------------ |
| `object` | `object` | Snapshot da organização conectada criada. Ver tabela abaixo. |

### `data.object`

| Campo                          | Tipo                      | Descrição                                                                                                                                                                                                      |
| ------------------------------ | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                           | `string`                  | ID público da organização conectada (`org_*`).                                                                                                                                                                 |
| `object`                       | `string`                  | Sempre `"organization"`.                                                                                                                                                                                       |
| `livemode`                     | `boolean`                 | `true` em produção; `false` em ambiente de teste.                                                                                                                                                              |
| `name`                         | `string`                  | Nome ou razão social.                                                                                                                                                                                          |
| `email`                        | `string \| null`          | E-mail principal da organização conectada.                                                                                                                                                                     |
| `avatar_url`                   | `string \| null`          | URL da imagem de perfil/logo, quando definida.                                                                                                                                                                 |
| `document`                     | `string \| null`          | CPF (PF) ou CNPJ (PJ), somente dígitos.                                                                                                                                                                        |
| `document_type`                | `"cpf" \| "cnpj" \| null` | Tipo fiscal.                                                                                                                                                                                                   |
| `website`                      | `string \| null`          | Site público da organização conectada.                                                                                                                                                                         |
| `socials`                      | `array`                   | Lista de `{ platform, url }`. `platform` é um enum: `x`, `github`, `facebook`, `instagram`, `youtube`, `linkedin`, `other`. Vazia quando não há redes cadastradas.                                             |
| `billing_name`                 | `string \| null`          | Nome usado em cobranças.                                                                                                                                                                                       |
| `billing_address`              | `object \| null`          | Endereço de cobrança quando informado. Campos: `line1`, `line2`, `city`, `state`, `postal_code`, `country`.                                                                                                    |
| `billing_additional_info`      | `string \| null`          | Informação adicional para cobranças (ex: setor responsável).                                                                                                                                                   |
| `branding_settings`            | `object`                  | Identidade visual aplicada ao checkout hospedado. Campos não configurados vêm `null`.                                                                                                                          |
| `created_at`                   | `string`                  | Data/hora de criação da organização conectada.                                                                                                                                                                 |
| `updated_at`                   | `string \| null`          | Data/hora da última modificação da organização conectada.                                                                                                                                                      |
| `activation_status`            | `string`                  | Status de ativação financeira: `activation_pending`, `pending`, `active` ou `disabled`. Normalmente nasce como `activation_pending`; pode refletir um cadastro financeiro já conhecido para o mesmo documento. |
| `activation_status_updated_at` | `string \| null`          | Data/hora ISO 8601 da última atualização de `activation_status`. `null` enquanto o status ainda não evoluiu.                                                                                                   |
| `bank_account`                 | `object \| null`          | Objeto [`bank_account`](/api-reference/bank-accounts/object) conectado à organização. `null` quando ainda não há conta conectada.                                                                              |
| `platform`                     | `string`                  | ID da sua plataforma (`plat_*`).                                                                                                                                                                               |
| `metadata`                     | `object`                  | Eco dos pares chave/valor que você passou em `metadata` na criação da organização. Objeto vazio (`{}`) quando você não passou nada.                                                                            |

## Uso típico

```typescript theme={}
switch (event.type) {
  case "organization.created": {
    const organization = event.data.object;
    await db.organizations.upsert({
      id: organization.id,
      name: organization.name,
      document: organization.document,
      activation_status: organization.activation_status,
      metadata: organization.metadata,
    });
    break;
  }
}
```