POST Create department

Changed on

Este endpoint permite que você crie um novo departamento no sistema.

Os departamentos ajudam a organizar usuários por setor ou área da empresa — por exemplo: comercial, financeiro, jurídico.

Atenção: o nome do departamento precisa ser único em toda a plataforma (não apenas na sua empresa); um nome já usado responde 422.

post/api/departments

Request

  • Base URL
    https://app.plugsign.com.br
  • URL
    https://app.plugsign.com.br/api/departments
  • Auth
    API key in header Authorization

Request body

namestring required

Nome do departamento. Precisa ser único na plataforma.

emailstring required

E-mail do departamento (precisa ser um e-mail válido).

Response

200

messagestring

Mensagem de confirmação retornada pela API.

Example response

{
  "message": "Departamento criado com sucesso!",
  "data": {
    "id": 217,
    "name": "departamento-teste",
    "email": "departamento@email.com"
  }
}

Changes