Criar Colaborador

Cria novo colaborador vinculado à empresa. Apenas empresa_id, nome_completo e cpf sao obrigatorios. Se senha_identificacao nao for enviada, a API gera a senha inicial com os 6 primeiros digitos do CPF. Requer scope colaboradores:write.

Autenticação:

🔑 API Key

Corpo

empresa_idnumber

Obrigatório

ID da empresa

departamento_idnumber

ID do departamento

nome_completostring

Obrigatório

Nome completo

cpfstring

Obrigatório

CPF (apenas números)

emailstring

telefonestring

Telefone do colaborador

generostring

Genero do colaborador

nascimentostring

Data de nascimento no formato ISO ou yyyy-mm-dd

data_admissaostring

Data de admissao no formato ISO ou yyyy-mm-dd

senha_identificacaostring

Senha de identificacao. Se omitida, a API gera a senha inicial com os 6 primeiros digitos do CPF

cargostring

Cargo do colaborador

localstring

Local de trabalho

Respostas

{
  "ok": true,
  "data": {
    "colaborador_id": 10,
    "empresa_id": 1,
    "departamento_id": null,
    "nome_completo": "Joao Silva",
    "cpf": "12345678900",
    "email": null,
    "cargo": null,
    "local": null,
    "status": "Ativo",
    "senha_inicial": "123456"
  }
}

Sandbox Mode

curl --request POST \
  'https://rep-gestor.youuponto.com/api/v1/colaboradores' \
  --header 'x-api-key: yk_sua_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "empresa_id": 1,
  "departamento_id": 5,
  "nome_completo": "João Silva",
  "cpf": "12345678900",
  "email": "joao@empresa.com",
  "telefone": "11999998888",
  "genero": "Masculino",
  "nascimento": "1990-05-19",
  "data_admissao": "2026-05-19",
  "senha_identificacao": "123456",
  "cargo": "Analista",
  "local": "Escritorio"
}'

Exemplos de Resposta

{
  "ok": true,
  "data": {
    "colaborador_id": 10,
    "empresa_id": 1,
    "departamento_id": null,
    "nome_completo": "Joao Silva",
    "cpf": "12345678900",
    "email": null,
    "cargo": null,
    "local": null,
    "status": "Ativo",
    "senha_inicial": "123456"
  }
}