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

# Criar usuário (produtor)

> Usado para provisionar um novo usuário no ecossistema Ticto via API.

**Rota:** `POST /api/v1/users` · **Headers:** `X-Api-Client-Token`

## Parâmetros obrigatórios (body)

<ParamField body="name" type="string" required>
  Nome do produtor (máximo 191 caracteres).
</ParamField>

<ParamField body="email" type="string" required>
  E-mail em formato válido.
</ParamField>

<ParamField body="cpf" type="string">
  CPF válido algoritmicamente. Obrigatório caso não envie `cnpj`.
</ParamField>

<ParamField body="cnpj" type="string">
  CNPJ válido algoritmicamente. Obrigatório caso não envie `cpf`.
</ParamField>

## Exemplo

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://nexus-sandbox.ticto.dev/api/v1/users \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -H "X-Api-Client-Token: <seu_client_auth_token>" \
    -d '{
      "name": "DEV Produtor",
      "email": "dev_produtor@ticto.com.br",
      "cpf": "<cpf_valido>"
    }'
  ```
</CodeGroup>

## Response de sucesso (201 Created)

```json theme={null}
{
  "data": {
    "code": "TSO3TY7IZM1756390792",
    "public_token": "bearer_token_para_operacoes_futuras",
    "name": "DEV Produtor",
    "email": "dev_produtor@ticto.com.br"
  }
}
```

<Check>
  Guarde o `public_token`: ele é o **User Token** usado no header `Authorization: Bearer` nas rotas do produtor.
</Check>


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