---
title: "Create a employee"
method: POST
path: "/employees/"
tags: ["Employees"]
---

# Create a employee

`POST /employees/`

The fields cpf, internal_number, and email are identifiers of the employee, with at least one of them being mandatory to fill in, and all three fields can contain information. The assignment of access profiles (permission_profiles) is not available via API and must be done directly through the platform, on the employee management screen. The access profile (permission_profiles) will only be displayed in the employee query as informational.

## Request body

- Employee
  - `name` string — Employee's name
  - `social_name` string — Employee's Social Name (max length: 250)
  - `birth_name` string — Employee's birth date (YYYY-MM-DD)
  - `email` string — Employee's e-mail
  - `cpf` string — Employee's CPF
  - `internal_number` string — Employee's internal number
  - `cell_phone` string — Employee's cell phone
  - `groups` string — Name or id_group of groups of employee separated by semicolon
  - `leaders` string — Name, CPF, internal_number of leaders of employee separated by semicolon. CPF can be provided with or without punctuation (e.g., 12345678901 or 123.456.789-01).
  - `language` string — pt-BR (default) / en-US / es-ES
  - `blocked` integer — Block employee from receiveing notifications
  - `sex` string — Employee's sex (F/M)
  - `gender` string — Employee's gender (max length: 250)
  - `birthday` string, date — Employee's birth date (YYYY-MM-DD)
  - `hiring_date` string, date — Employee's hiring date (YYYY-MM-DD)
  - `resignation_date` string, date — Employee's resignation date (YYYY-MM-DD)
  - `position` string — Employee's job role
  - `scholarity` string — Employee's scholarity
  - `unit_business` string — Employee's business unit
  - `unit_geography` string — Employee's geographic unit
  - `tags` string[]
  - `custom_attributes` CustomAttributes
    - `attribute_name` string — string

## Response `200`

Successful response

- object
  - `code` integer — Can be 1 for success, otherwise 0 for error
  - `message` string
  - `values` object
    - `id_person` integer

---

[API](https://skmtc.net/gupy/apis/gupy-public-api.md) · [All operations](https://skmtc.net/gupy/apis/gupy-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gupy/gupy-public-api/versions/3f26defa2a42/schema)