---
title: "POST Create team user"
method: POST
path: "/api/teams"
---

# POST Create team user

`POST /api/teams`

Com este endpoint você pode criar contas de colaboradores, para que os mesmos possuam acesso ao sistema via front-end e possam utilizar a plataforma, assim como visualizar os dados submetidos via API.

Caso não queira fornecer acessos aos colaboradores, é possível manipular o sistema sem tais contas, executando todas as ações como administrador do sistema.

**Atenção!** Ao criar uma conta de colaborador, é possível avisá-lo ou não da criação. Caso você informe o parâmetro `password`, ele não será avisado da criação da conta nem receberá alertas do sistema (para uso WhiteLabel). Caso NÃO passe uma senha, o sistema vai gerar uma automaticamente e enviar para o e-mail do colaborador, portanto ele terá conhecimento da conta e uma forma de acessar a plataforma.

## Request body

- object
  - `name` string, required — Primeiro nome do cliente adicionado na plataforma.
  - `last_name` string, required — Sobrenome do cliente adicionado na plataforma.
  - `birth` string, date — Data de nascimento do colaborador no formato ano-mês-dia. Exemplo: 1990-05-12.
  - `phone` string — Número de telefone com o 9 do cliente, caso seja um WhatsApp, o mesmo será utilizado para envio de alertas e notificações, incluindo quando uma assinatura for solicitada ao mesmo.
  - `email` string, required — Endereço de e-mail do cliente adicionado na plataforma.
  - `cpf` string — CPF do cliente devidamente formatado ou apenas números.
  - `recive_email` string — Se o usuário vai receber e-mails do sistema, 0 = Não recebe nada, 1 = Recebe tudo, 2 = Recebe somente solicitações.
  - `recive_whatsapp` string — Se o usuário vai receber mensagens de WhatsApp do sistema, 0 = Não recebe nada, 1 = Recebe tudo, 2 = Recebe somente solicitações.
  - `cert_file` string, binary — Arquivo do certificado digital PFX.
  - `cert_password` string — Senha do certificado para validação, caso passe o certificado a senha é obrigatória.
  - `password` string — Senha do seu colaborador para cadastro, caso não seja fornecida o sistema irá gerar uma senha temporária e enviará para ele por e-mail, caso passe uma senha, o sistema não vai avisa-lo sobre a criação da conta e não vai enviar alertas para o mesmo.
  - `permissions` string[], required — Obrigatório mesmo que um array vazio ['upload', 'edit', 'delete' 'protect', 'send_request', 'view_all_requests'].
  - `role` 'admin' | 'user' | 'staff' — Cargo do usuário.

## Response `200`

200

- object
  - `data` object — Objeto principal contendo os dados do colaborador criado.
    - `id` integer — Identificador único do colaborador.
    - `name` string — Primeiro nome do colaborador.
    - `last_name` string — Sobrenome do colaborador.
    - `email` string — E-mail do colaborador.
    - `cpf` string — CPF do colaborador.
    - `phone` string — Telefone do colaborador.
    - `permissions` string[] — Lista de permissões do colaborador na plataforma.
    - `recive_email` integer — Indica se o colaborador recebe notificações por e-mail. 1 = sim, 0 = não.
    - `recive_whatsapp` integer — Indica se o colaborador recebe notificações por WhatsApp. 1 = sim, 0 = não.
    - `role` 'admin' | 'user' | 'staff' — Papel/função do colaborador na plataforma.
    - `status` string — Status da conta do colaborador.

---

[API](https://skmtc.net/plugsign/apis/endpoints-manuais.md) · [All operations](https://skmtc.net/plugsign/apis/endpoints-manuais/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plugsign/endpoints-manuais/revisions/41e10c7c691b/schema)