> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /api/v1/sdk/organizations

> Cria uma nova sub-organização vinculada à organização pai autenticada.

Cria uma sub-organização dentro do ecossistema Chargefy. A nova organização é automaticamente vinculada como filha da organização pai identificada pelo token de acesso. Retorna o objeto da sub-organização criada com status HTTP `201 Created`.

## Autenticação

Requer **Organization Access Token (OAT)** da organização pai via header `Authorization: Bearer`.

## Corpo da Requisição

**name** `string` *required*

Nome da sub-organização.

**slug** `string` *required*

Identificador desejado em formato de slug (letras minúsculas, números e hífens). Deve ser único globalmente; se já existir, a API grava um slug alternativo no formato `slug-12345` (número aleatório curto) e devolve esse valor em `suborganization.slug` na resposta.

**email** `string`

Endereço de e-mail principal da sub-organização.

**website** `string`

URL do site da sub-organização.

**description** `string`

Descrição da sub-organização.

## Resposta

Retorna o objeto da sub-organização criada com status `201 Created`.

**suborganization** `object`

Dados da sub-organização criada.

**suborganization.id** `string`

Identificador único da sub-organização criada.

**suborganization.name** `string`

Nome da sub-organização.

**suborganization.slug** `string`

Slug efetivo da sub-organização (pode diferir do enviado se houve colisão; use sempre este valor nas integrações).

**suborganization.status** `string`

Status inicial (`"created"`).

**status** `string`

Status do processo de criação (`"pending_review"`).

## Exemplo

```bash cURL theme={null}
curl -X POST "https://api.chargefy.io/api/v1/sdk/organizations" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Vendedor Gamma",
    "slug": "vendedor-gamma",
    "email": "contato@vendedorgamma.com"
  }'
```

```typescript SDK theme={null}
import { Chargefy } from '@chargefy/sdk';
const chargefy = new Chargefy({ accessToken: process.env.CHARGEFY_ACCESS_TOKEN });
const result = await chargefy.sdk.organizations.create({
  name: 'Vendedor Gamma',
  slug: 'vendedor-gamma',
  email: 'contato@vendedorgamma.com',
});
```

## Resposta de Exemplo

```json theme={null}
{
  "suborganization": {
    "id": "org_01j9abc333",
    "name": "Vendedor Gamma",
    "slug": "vendedor-gamma",
    "status": "created"
  },
  "status": "pending_review"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.