---
title: "POST /v1/scf/financiers-payer"
method: POST
path: "/v1/scf/financiers-payer"
tags: ["Sacado-Simples"]
---

# POST /v1/scf/financiers-payer

`POST /v1/scf/financiers-payer`

## Request

- Base URL: `https://api.sandbox.empresas.btgpactual.com`
- URL: `https://api.sandbox.empresas.btgpactual.com/v1/scf/financiers-payer`
- 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`

## Request body

- FinancierBody
  - `PartnerConfigurationId` string, required
  - `Name` string
  - `Identification` string, required
  - `BirthDate` string, date
  - `PhoneNumber` string
  - `EmailAddress` string
  - `Addresses` FinancierAddress[]
    - `cityName` string, required
    - `complement` string
    - `countryCode` string, required
    - `countryName` string, required
    - `neighborhood` string, required
    - `number` string, required
    - `stateCode` string, required
    - `street` string, required
    - `type` string, required
    - `zipCode` string, required
  - `Documents` FinancierDocument[]
    - `Type` 'IDENTIFICACAO' | 'BIOMETRIA' | 'CONTRATO_SOCIAL' | 'ATA_ELEICAO'
    - `SubType` 'CNH' | 'SELFIE', required
    - `Files` FinanciersFiles[], required
      - `Name` string, required
      - `Url` string, required: url de documento enviado pela API de files
      - `PageType` 'MULTI_PAGINAS' | 'FRENTE' | 'VERSO' | 'COMPLETO', required
      - `Extension` 'pdf' | 'jpg' | 'jpeg' | 'docx' | 'doc' | 'png' | 'jfif' | 'ai', required

## Response `201`

Sucesso

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[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)
