---
title: "Cadastrar colaboradores (onboarding)"
method: POST
path: "/{companyId}/banking/payroll/onboarding/employees"
tags: ["Onboarding"]
---

# Cadastrar colaboradores (onboarding)

`POST /{companyId}/banking/payroll/onboarding/employees`

Submete um ou mais colaboradores para abertura de conta BTG. O processamento é assíncrono e retorna `202 Accepted` imediatamente.

O campo `issuingAuthority` aceita apenas os códigos retornados por `GET /{companyId}/banking/payroll/onboarding/issuers`.

## Path parameters

- `companyId` string, required

## Headers

- `X-Idempotency-Key` string, uuid, required

## Request body

- EmployeeRequest[]
  - `companyTaxId` string, nullable
  - `name` string, nullable
  - `taxId` string, nullable
  - `email` string, nullable
  - `phone` string, nullable
  - `admissionDate` string, nullable
  - `grossMonthlySalary` number, double
  - `accountType` string, nullable
  - `idNumber` string, nullable
  - `issuingAuthority` string, nullable — Código do emissor do documento de identidade. Deve ser um dos valores retornados por GET /payroll/issuers. Valores arbitrários são rejeitados com 400.
  - `address` AddressRequest
    - `street` string, nullable
    - `number` string, nullable
    - `neighborhood` string, nullable
    - `zipCode` string, nullable
  - `isUnderage` boolean
  - `representative` LegalRepresentativeRequest
    - `taxId` string, nullable
    - `phone` string, nullable
    - `email` string, nullable
    - `idNumber` string, nullable
    - `issuingAuthority` string, nullable

## Response `202`

Accepted

- SubmitEmployeesResponse
  - `status` string, nullable

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `500` — Server Error

---

[API](https://skmtc.net/btgpactual/apis/folha-de-pagamentos.md) · [All operations](https://skmtc.net/btgpactual/apis/folha-de-pagamentos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/btgpactual/folha-de-pagamentos/revisions/2a24d3da114c/schema)