> ## 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/:id/members/invite

> Envia um convite por e-mail para um novo membro entrar na organização

Envia um convite por e-mail para um usuário ingressar na organização. Se o e-mail já for membro ativo, retorna `200` sem enviar novo e-mail. Se já existia um convite pendente, ele é substituído por um novo.

## Autenticação

Requer **token de usuário (JWT Supabase)** via header `Authorization: Bearer`. O usuário deve pertencer à organização.

## Parâmetros de Path

**id** `string` *required*

ID da organização

## Corpo da Requisição

**email** `string` *required*

E-mail do usuário a ser convidado

## Resposta

| Status | Descrição |
| - | - |
| `201` | Convite criado e e-mail enviado com sucesso |
| `200` | O e-mail já é membro ativo da organização |

**message** `string`

Mensagem de resultado: `"Convite enviado"` ou `"Membro já adicionado"`

## Erros

| Código | Descrição |
| - | - |
| `400` | Campo `email` ausente |
| `404` | Organização não encontrada ou acesso negado |

## Exemplo

```bash cURL theme={null}
curl -X POST "https://api.chargefy.io/api/v1/organizations/org_abc123/members/invite" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"email": "novo@colaborador.com.br"}'
```

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

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

await chargefy.organizations.inviteMember('org_abc123', {
  email: 'novo@colaborador.com.br',
});
```

## Resposta de Exemplo

```json theme={null}
{
  "message": "Convite enviado"
}
```


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