---
title: "POST /api/v1/employees/sync"
method: POST
path: "/api/v1/employees/sync"
tags: ["Public API"]
---

# POST /api/v1/employees/sync

`POST /api/v1/employees/sync`

Cria ou atualiza um colaborador.

## Request body

- object
  - `integrationId` string, required — Identificador único de sua escolha para esse colaborador
  - `forceCreate` boolean — Quando `true`, ignora a busca por colaboradores existentes (por `integrationId`, `cpf`, `workEmail` e `fullName`) e cria um novo colaborador. Útil para cadastrar intencionalmente um colaborador duplicado.
  - `fullName` string, required — Nome completo
  - `socialName` string — Nome social
  - `status` 'active' | 'terminated' | 'on-hold', required — Situação do colaborador
  - `workEmail` string — E-mail profissional
  - `personalEmail` string — E-mail pessoal
  - `workPhoneNumber` string — Telefone profissional
  - `personalPhoneNumber` string — Telefone pessoal
  - `cpf` string — Número do CPF
  - `position` string — Cargo do colaborador
  - `area` string — Área do colaborador
  - `managerFullName` string — Nome do gestor
  - `birthDate` string — Data de nascimento
  - `admittedAt` string — Data de admissão
  - `terminatedAt` string — Data de desligamento
  - `address` object — Endereço do colaborador
    - `zipCode` string — CEP
    - `streetName` string — Nome da rua
    - `streetNumber` string — Número da casa
    - `complement` string — Complemento do endereço
    - `neighborhood` string — Bairro
    - `city` string — Cidade
    - `state` string — Estado
    - `country` string — País

## Response `200`

- object
  - `id` string, required — Identificador do colaborador na plataforma Salvy (UUID)
  - `fullName` string, required — Nome completo
  - `socialName` string, nullable, required — Nome social
  - `status` 'active' | 'terminated' | 'on-hold', required — Situação do colaborador
  - `workEmail` string, nullable, required — A valid email address.
  - `personalEmail` string, nullable, required — A valid email address.
  - `workPhoneNumber` string, nullable, required — Phone number in E.164 format. Supports Brazilian numbers (+55).
  - `personalPhoneNumber` string, nullable, required — Phone number in E.164 format. Supports Brazilian numbers (+55).
  - `cpf` string, nullable, required — A valid CPF number.
  - `cnpj` string, nullable, required — A valid CNPJ number (numeric or alphanumeric).
  - `rg` string, nullable, required — RG do colaborador
  - `position` string, nullable, required — Cargo do colaborador
  - `area` string, nullable, required — Área do colaborador
  - `managerFullName` string, nullable, required — Nome do gestor
  - `birthDate` string, nullable, required — A date in ISO 8601 format.
  - `contractType` 'pj' | 'clt' | 'intern' | 'apprentice' | 'temporary' | 'third-party', nullable, required — Tipo de contrato
  - `contractEndDate` string, nullable, required — A date in ISO 8601 format.
  - `admittedAt` string, nullable, required — A date in ISO 8601 format.
  - `terminatedAt` string, nullable, required — A date in ISO 8601 format.
  - `address` object, nullable, required — Endereço do colaborador
    - `zipCode` string, nullable, required — CEP
    - `streetName` string, nullable, required — Nome da rua
    - `streetNumber` string, nullable, required — Número da casa
    - `complement` string, nullable, required — Complemento do endereço
    - `neighborhood` string, nullable, required — Bairro
    - `city` string, nullable, required — Cidade
    - `state` string, nullable, required — Estado
    - `country` string, nullable, required — País
  - `customFields` object[], required — Campos personalizados do colaborador
    - `label` string, required
    - `type` 'text' | 'select', required
    - `value` string, required
  - `bankAccount` object, nullable, required — Dados bancários do colaborador
    - `bank` string, nullable, required — Banco
    - `branch` string, nullable, required — Agência
    - `accountNumber` string, nullable, required — Número da conta
    - `accountType` 'checking' | 'savings' | 'salary' | 'payment', nullable, required — Tipo de conta
    - `pixKey` string, nullable, required — Chave PIX
  - `salaryCents` number, nullable, required — Salário em centavos
  - `sources` union[], required — Fontes de integração do colaborador
    - union
      - object
        - `id` 'manual', required
        - `platform` 'manual', required
      - object
        - `id` string, required
        - `platform` 'sheets', required
      - object
        - `id` string, required
        - `platform` string, required
  - `createdAt` string, date-time, required — Data de criação do colaborador

## Other responses

- `401`
- `403`
- `404`
- `413`
- `422`
- `500`

---

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