> ## 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/organizations/

> Cria uma nova organização e associa ao usuário autenticado

Cria uma nova organização e automaticamente associa o usuário autenticado como membro. O usuário deve ter um registro em `public.users` (ser um admin registrado).

## Autenticação

Requer **token de usuário (JWT Supabase)** via header `Authorization: Bearer`.

## Corpo da Requisição

**name** `string` *required*

Nome da organização

**slug** `string` *required*

Slug único para URL (deve ser único no sistema)

**terms** `boolean` *required*

Aceite dos termos de uso (deve ser `true`)

**bio** `string`

Biografia ou descrição da organização

**company** `string`

Nome da empresa

**blog** `string`

URL do blog

**location** `string`

Localização

**email** `string`

E-mail de contato público

**twitter\_username** `string`

Nome de usuário no Twitter/X

**website** `string`

URL do site

**avatar\_url** `string`

URL do avatar

**profile\_settings** `object`

Configurações de perfil

**feature\_settings** `object`

Configurações de funcionalidades

**subscription\_settings** `object`

Configurações de assinaturas

**notification\_settings** `object`

Configurações de notificações

**socials** `array`

Links de redes sociais

## Resposta

Retorna o objeto completo da organização criada com status HTTP `201 Created`.

**id** `string`

ID único da organização

**name** `string`

Nome da organização

**slug** `string`

Slug único

**status** `string`

Status inicial: `created`

**customer\_invoice\_prefix** `string`

Prefixo das faturas (gerado automaticamente a partir do slug em maiúsculas)

**customer\_invoice\_next\_number** `integer`

Próximo número de fatura (inicia em `1`)

**subscription\_settings** `object`

Configurações padrão de assinaturas

**notification\_settings** `object`

Configurações padrão de notificações

**created\_at** `string`

Data de criação (ISO 8601)

## Erros

| Código | Descrição |
| - | - |
| `400` | `name` ou `slug` ausentes, ou `terms` não aceito |
| `403` | Usuário não tem permissão para criar organizações |
| `422` | Slug já existe no sistema |

## Exemplo

```bash cURL theme={null}
curl -X POST "https://api.chargefy.io/api/v1/organizations/" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Minha Empresa",
    "slug": "minha-empresa",
    "terms": true,
    "bio": "Empresa de tecnologia",
    "email": "contato@minhaempresa.com.br",
    "website": "https://minhaempresa.com.br"
  }'
```

```typescript SDK theme={null}
import { Chargefy } from '@chargefy/sdk';

const chargefy = new Chargefy({
  accessToken: process.env.CHARGEFY_ACCESS_TOKEN,
});

const org = await chargefy.organizations.create({
  name: 'Minha Empresa',
  slug: 'minha-empresa',
  terms: true,
  bio: 'Empresa de tecnologia',
  email: 'contato@minhaempresa.com.br',
  website: 'https://minhaempresa.com.br',
});
```

## Resposta de Exemplo

```json theme={null}
{
  "id": "org_abc123",
  "name": "Minha Empresa",
  "slug": "minha-empresa",
  "avatar_url": null,
  "bio": "Empresa de tecnologia",
  "email": "contato@minhaempresa.com.br",
  "website": "https://minhaempresa.com.br",
  "status": "created",
  "next_review_threshold": 0,
  "customer_invoice_prefix": "MINHA-EMPRESA",
  "customer_invoice_next_number": 1,
  "profile_settings": {},
  "feature_settings": {},
  "subscription_settings": {
    "allow_multiple_subscriptions": false,
    "allow_customer_updates": true,
    "proration_behavior": "prorate"
  },
  "notification_settings": {
    "new_sale": true,
    "new_subscription": true
  },
  "socials": [],
  "details": {},
  "created_at": "2026-03-23T10:00:00Z",
  "modified_at": null,
  "onboarded_at": null
}
```


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