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

# Criar usuários

> Crie um ou mais usuários na empresa associada ao token de integração.

Cria usuários com perfil de aluno. O corpo deve ser um array JSON.

## Corpo da requisição

<ParamField body="name" type="string" required>
  Nome do usuário.
</ParamField>

<ParamField body="password" type="string" required>
  Senha inicial. A API armazena somente o hash da senha.
</ParamField>

<ParamField body="email" type="string">
  E-mail do usuário. Envie `email`, `cpf` ou ambos.
</ParamField>

<ParamField body="cpf" type="string">
  CPF válido, com ou sem pontuação. Envie `cpf`, `email` ou ambos.
</ParamField>

<ParamField body="status" type="integer" default="1">
  Use `1` para ativo ou `2` para bloqueado.
</ParamField>

<ParamField body="custom_field_values" type="object">
  Valores dos campos personalizados configurados para a empresa. Os nomes não diferenciam maiúsculas de minúsculas.
</ParamField>

<ParamField body="teams" type="string[]">
  Nomes de times ativos que já existem na empresa. A comparação dos nomes não diferencia maiúsculas de minúsculas.
</ParamField>

```bash cURL theme={null}
curl -X POST https://api.crescamais.com/integrations/users \
  -H "Authorization: Bearer SEU_TOKEN_DE_INTEGRACAO" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "name": "João da Silva",
      "email": "joao@empresa.com",
      "cpf": "184.986.700-39",
      "password": "senha-inicial",
      "status": 1,
      "custom_field_values": {
        "Setor": "Marketing",
        "Cidade": "São Paulo"
      },
      "teams": ["Marketing", "Novos colaboradores"]
    }
  ]'
```

## Resposta

A API retorna `200 OK` após processar o lote.

```json theme={null}
{
  "message": "Integration process completed.",
  "summary": {
    "total_received": 1,
    "total_created": 1,
    "total_rejected": 0,
    "total_skipped": 0
  },
  "details": {
    "created": [
      {
        "user": {
          "name": "João da Silva",
          "email": "joao@empresa.com",
          "password": "senha-inicial",
          "status": 1
        },
        "status": "created",
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
    ],
    "rejected": [],
    "skipped": []
  },
  "timestamp": "2026-09-03T12:00:00.000Z"
}
```

| Resultado  | Significado                                                                                                     |
| ---------- | --------------------------------------------------------------------------------------------------------------- |
| `created`  | O usuário foi criado.                                                                                           |
| `rejected` | Um CPF ou campo personalizado numérico é inválido. Consulte `reason`.                                           |
| `next`     | O item foi ignorado. Isso ocorre quando falta e-mail e CPF, o usuário já existe ou há uma solicitação pendente. |

<Warning>
  O objeto `user` da resposta repete o item enviado e pode conter a senha inicial. Não registre o corpo completo da resposta em logs.
</Warning>

## Erros

| Status | Causa                                                            |
| ------ | ---------------------------------------------------------------- |
| `401`  | Token ausente, malformado ou inválido.                           |
| `400`  | A empresa não possui um grupo de aluno.                          |
| `500`  | O corpo não segue o formato esperado ou ocorreu um erro interno. |