---
title: "Criar recebedor contrato antigo"
method: POST
path: "/recipients1"
---

# Criar recebedor contrato antigo

`POST /recipients1`

## Request

- Base URL: `https://api.pagar.me/core/v5`
- URL: `https://api.pagar.me/core/v5/recipients1`
- Auth: HTTP basic

Rota para criar um recebedor, definindo os dados do recebedor, transferência e qual a conta bancária que será utilizada para envio dos pagamentos.

## Request body

- object
  - `name` string, required: Nome do recebedor. Max:128 caracteres
  - `email` string: E-mail do recebedor. Max: 64 caracteres
  - `description` string: Descrição do recebedor. Max:256 caracteres
  - `document` string, required: CPF ou CNPJ do recebedor. Max: 16 caracteres
  - `type` string, required: Tipo de recebedor. Valores possíveis: **individual** (pessoa física) ou **company** (pessoa jurídica)
  - `code` string: Referencia externa única por recebedor
  - `default_bank_account` object: Dados da conta bancária do recebedor.
    - `holder_name` string, required: Nome da conta. Max: 30 caracteres
    - `bank` string, required: Código do banco. Max 3 caracteres numéricos
    - `branch_number` string, required: Número da agência. Max 4 caracteres
    - `branch_check_digit` string: Digito validador da agência. Max: 1 caracter numérico
    - `account_number` string, required: Número da conta. Max: 13 caracteres numéricos
    - `account_check_digit` string, required: Digitos validadores da conta. Max 2 caracteres numéricos
    - `holder_type` string, required: Tipo do documento. "individual" ou "company"
    - `holder_document` string, required: Número do documento do titular da conta. Deve ser igual ao documento do recebedor. Somente números
    - `type` string, required: Tipo da conta. Valores Possiveis: "checking" ou "savings"
  - `transfer_settings` object: Informações de transferência do recebedor
    - `transfer_enabled` boolean: Indica se o recebedor receberá seus pagamentos automaticamente.
    - `transfer_interval` string: Indica a frequência das transferências automáticas para a conta do recebedor. Valores possíveis: "Daily", "Weekly" ou "Monthly".
    - `transfer_day` integer: Indica o dia em que ocorrerá as transferências automáticas.
  - `automatic_anticipation_settings` object: Informações de antecipação automática do recebedor
    - `enabled` boolean: Indica se o recebedor receberá antecipações automaticamente
    - `type` string: Indica o tipo de antecipação automática que será configurado para a conta do recebedor. Valores possíveis "full" e "1025"
    - `volume_percentage` string: Indica a porcentagem do volume passível de ser antecipado para o recebedor.
    - `delay` string: Indica a quantidade de dias que serão desconsiderados na contabilização do valor passível de ser antecipado. A contagem de dias é realizada a partir do dia da antecipação para trás
  - `metadata` string: Objeto chave/valor utilizado para armazenar informações adicionais sobre o recebedor.

## Response `200`

200

- object
  - `id` string
  - `name` string
  - `email` string
  - `document` string
  - `description` string
  - `type` string
  - `status` string
  - `created_at` string
  - `updated_at` string
  - `transfer_settings` object
    - `transfer_enabled` boolean
    - `transfer_interval` string
    - `transfer_day` integer
  - `default_bank_account` object
    - `id` string
    - `holder_name` string
    - `holder_type` string
    - `holder_document` string
    - `bank` string
    - `branch_number` string
    - `branch_check_digit` string
    - `account_number` string
    - `account_check_digit` string
    - `type` string
    - `status` string
    - `created_at` string
    - `updated_at` string
    - `metadata` object
      - `key` string
  - `gateway_recipients` object[]
    - `gateway` string
    - `status` string
    - `pgid` string
    - `createdAt` string
    - `updatedAt` string
  - `automatic_anticipation_settings` object
    - `enabled` boolean
    - `type` string
    - `volume_percentage` integer
    - `delay` integer
  - `metadata` object
    - `key` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ef323290c0ff`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pagar/apis/pagarme-api/changes/recipients1/post.md)

---

[API](https://skmtc.dev/pagar/apis/pagarme-api.md) - [All operations](https://skmtc.dev/pagar/apis/pagarme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pagar/apis/pagarme-api/revisions/ef323290c0ff?raw)