> ## 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.

# Criar Sessão

> Cria uma sessão de cliente via e-mail com magic link ou ID da organização.

Inicia uma sessão do portal do cliente. Envia um magic link por e-mail para autenticação sem senha.

## Autenticação

> [!NOTE]
>
> Este endpoint **não requer autenticação**. É o ponto de entrada para obter um token de sessão.

## Requisição

**email** `string` *required*

E-mail do cliente cadastrado na plataforma.

**organization\_id** `string`

ID da organização. Obrigatório quando o cliente pertence a múltiplas organizações.

**return\_url** `string`

URL de redirecionamento após autenticação via magic link.

```bash cURL theme={null}
curl -X POST https://api.chargefy.io/api/v1/customer-portal/sessions \
  -H "Content-Type: application/json" \
  -d '{
    "email": "cliente@exemplo.com.br",
    "organization_id": "org_abc123",
    "return_url": "https://meusite.com.br/portal"
  }'
```

## Resposta

**token** `string`

Token de sessão do cliente (formato `cst_xxx`). Retornado apenas em ambiente sandbox.

```json Resposta 201 theme={null}
{
  "token": "cst_abc123def456"
}
```

> [!WARNING]
>
> Em ambiente de **produção**, o token não é retornado na resposta. O cliente recebe um magic link por e-mail para autenticação.


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