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

# Criar usuário em várias escolas

> Cadastre novos alunos no Toolzz em uma ou mais escolas da sua instituição

## Parâmetros

<ParamField body="email" type="string" required>
  E-mail do novo usuário.
</ParamField>

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

<ParamField body="schools" type="number[]" required>
  ID da escola ou escolas, na qual deseja cadastrar este novo usuário.
</ParamField>

<ParamField body="permission" type="int" required>
  Permissão do novo usuário. Valores permitidos: 2, 3, 4, 5.
</ParamField>

<ParamField body="cpf" type="string">
  CPF do novo usuário.
</ParamField>

<ParamField body="phone" type="string">
  Telefone do novo usuário.
</ParamField>

<ParamField body="birth_date" type="date">
  Data de nascimento do novo usuário.
</ParamField>

<ParamField body="password" type="string">
  Senha do novo usuário.
</ParamField>

<Note>Antes de utilizar este endpoint, certifique-se de possuir os seguintes parâmetros disponíveis:</Note>

* **E-mail** `obrigatório`: O endereço de e-mail do novo estudante a ser adicionado.
* **Nome** `obrigatório`: O nome completo do estudante que está sendo incluído.
* **Escolas** `obrigatório`: Caso pertinente, é possível vincular o estudante a uma ou mais escolas.

## Descrição da Resposta

Abaixo está um exemplo da resposta retornada por este endpoint.

<ResponseField name="data" type="object">
  Detalhes do perfil do usuário.

  <Expandable title="properties">
    <ResponseField name="ra" type="string">
      Número de registro (pode ser nulo).
    </ResponseField>

    <ResponseField name="img_perfil" type="string">
      Nome do arquivo da imagem de perfil.
    </ResponseField>

    <ResponseField name="nome_completo" type="string">
      Nome completo do usuário.
    </ResponseField>

    <ResponseField name="data_nascimento" type="string">
      Data de nascimento (pode ser nula).
    </ResponseField>

    <ResponseField name="cpf" type="string">
      CPF (Cadastro de Pessoa Física) (pode ser nulo).
    </ResponseField>

    <ResponseField name="rg" type="string">
      RG (Registro Geral) (pode ser nulo).
    </ResponseField>

    <ResponseField name="telefone" type="string">
      Telefone de contato (pode ser nulo).
    </ResponseField>

    <ResponseField name="ocupacao" type="string">
      Ocupação do usuário (pode ser nula).
    </ResponseField>

    <ResponseField name="genero" type="string">
      Gênero (pode ser nulo).
    </ResponseField>

    <ResponseField name="descricao" type="string">
      Descrição adicional (pode ser nula).
    </ResponseField>

    <ResponseField name="escola_id" type="number">
      Identificador único da escola associada.
    </ResponseField>

    <ResponseField name="permissao" type="string">
      Nível de permissão do usuário.
    </ResponseField>

    <ResponseField name="ultima_atividade" type="string">
      Data e hora da última atividade.
    </ResponseField>

    <ResponseField name="trial" type="number">
      Indica se o usuário está em período de teste (0 = Não, 1 = Sim).
    </ResponseField>

    <ResponseField name="status_id" type="number">
      Identificador de status do usuário.
    </ResponseField>

    <ResponseField name="name" type="string">
      Nome do usuário.
    </ResponseField>

    <ResponseField name="email" type="string">
      Endereço de e-mail do usuário.
    </ResponseField>

    <ResponseField name="terms" type="string">
      Indica se o usuário aceitou os termos.
    </ResponseField>

    <ResponseField name="privilegio_id" type="string">
      Identificador do nível de privilégio.
    </ResponseField>

    <ResponseField name="uuid" type="string">
      Identificador Universal Único (UUID) do usuário.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Data e hora da última atualização do perfil.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Data e hora da criação do perfil.
    </ResponseField>

    <ResponseField name="id" type="number">
      Identificador único do usuário.
    </ResponseField>
  </Expandable>
</ResponseField>

## Segurança

Para acessar este endpoint, é necessário enviar um token de acesso válido no cabeçalho de autorização (Authorization) da requisição. Além disso, a API é protegida por outras medidas de segurança para garantir a proteção dos dados dos usuários.