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

# Cadastrar colaboradores (onboarding)

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

## Request

- Base URL: `https://api.sandbox.empresas.btgpactual.com`
- URL: `https://api.sandbox.empresas.btgpactual.com/{companyId}/banking/payroll/onboarding/employees`
- Auth: OAuth 2
  - Authorization code: `https://id.empresas.btgpactual.com/oauth2/authorize`
  - Token URL: `https://id.empresas.btgpactual.com/oauth2/token` scopes: `brn:btg:empresas:banking:payroll`

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.dev/btgpactual/apis/folha-de-pagamentos.md) - [All operations](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/llms.txt) - [OpenAPI document](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/revisions/2a24d3da114c?raw)
