---
title: "Adicionar beneficiários"
method: POST
path: "/beneficiaries"
---

# Adicionar beneficiários

`POST /beneficiaries`

Este endpoint é usado para adicionar beneficiários à conta Grafeno.

## Request body

- object
  - `name` string — Nome completo ou razão social do beneficiário.
  - `documentNumber` string — Número do documento do beneficiário, podendo ser CPF (para pessoas físicas) ou CNPJ (para pessoas jurídicas).
  - `bankCode` string — Código do banco onde a conta beneficiária está registrada.
  - `agency` string — Número da agência bancária do beneficiário.
  - `account` string — Número da conta bancária do beneficiário, incluindo o dígito verificador.
  - `pixDetails` object — Dados referentes a chave PIX do beneficiário.
    - `key` string — Chave PIX do beneficiário.
    - `keyType` 'cnpj' | 'cpf' | 'email' | 'phone' | 'evp' — Tipo da chave PIX do beneficiário. valores possíveis: cnpj, cpf, email, phone, evp.

## Response `200`

200

- object
  - `data` object
    - `id` string
    - `type` string
    - `attributes` object
      - `name` string
      - `agency` string
      - `account` string
      - `documentNumber` string
      - `bankCode` string
      - `createdAt` string
      - `updatedAt` string
      - `releaseAt` string
      - `pixDetails` object
        - `keyType` string
        - `key` string

## Other responses

- `400` — 400
- `401` — 401
- `422` — 422

---

[API](https://skmtc.net/grafeno/apis/api-v2-grafeno.md) · [All operations](https://skmtc.net/grafeno/apis/api-v2-grafeno/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grafeno/api-v2-grafeno/revisions/20f928f6933f/schema)