---
title: "Create"
method: POST
path: "/payments/recipients"
tags: ["Payment Recipient"]
---

# Create

`POST /payments/recipients`

Creates the payment recipient resource

## Request body

- CreatePaymentRecipient — Request with information to create a payment recipient.
  - `taxNumber` string, required — Account owner tax number. Can be CPF or CNPJ (only numbers)
  - `name` string, required — Account owner name.
  - `paymentInstitutionId` string, uuid, required — Primary identifier of the institution associated to the payment recipient.
  - `account` PaymentRecipientAccount, required — Payment receiver bank account information
    - `branch` string, required — Receiver bank account branch (agency)
    - `number` string, required — Receiver bank account number
    - `type` string, required — Receiver bank account type, could be: 'CHECKING_ACCOUNT', 'SAVINGS_ACCOUNT' or 'GUARANTEED_ACCOUNT'

## Response `200`

Create a payment recipient.

- PaymentRecipient — Bank-account payment recipient. Returned by `/payments/recipients` endpoints and embedded inside payment requests when the request targets a registered recipient.
  - `type` 'BANK_ACCOUNT', required — Recipient discriminator. Always `BANK_ACCOUNT` for this schema.
  - `id` string, required — Primary identifier
  - `taxNumber` string, required — Account owner tax number. Can be CPF or CNPJ (only numbers).
  - `name` string, required — Account owner name.
  - `paymentInstitution` PaymentInstitution, required — Response with information related to a payment institution
    - `id` string, required — Primary identifier
    - `name` string, required — Payment institution name
    - `tradeName` string, required — Payment institution trade name
    - `ispb` string, required — Payment institution ISPB
    - `compe` string — Payment institution COMPE
    - `createdAt` string, date-time, required — Date when the payment institution was created
    - `updatedAt` string, date-time, required — Date when the payment institution was updated
  - `isDefault` boolean, required — Indicates if the recipient is the default one
  - `account` PaymentRecipientAccount, required — Payment receiver bank account information
    - `branch` string, required — Receiver bank account branch (agency)
    - `number` string, required — Receiver bank account number
    - `type` string, required — Receiver bank account type, could be: 'CHECKING_ACCOUNT', 'SAVINGS_ACCOUNT' or 'GUARANTEED_ACCOUNT'
  - `pixKey` string — Pix key associated with the payment recipient
  - `createdAt` string, date-time, required — Date when the payment recipient was created
  - `updatedAt` string, date-time, required — Date when the payment recipient was last updated

## Other responses

- `400` — Payment Recipient its Invalid

---

[API](https://skmtc.dev/pluggy/apis/pluggy-api.md) · [All operations](https://skmtc.dev/pluggy/apis/pluggy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pluggy/pluggy-api/revisions/75e87ec7f9cd/schema)