---
title: "Add a bank account to an account"
method: POST
path: "/v2/accounts/{account_id}/bank-account"
tags: ["Bank account management"]
---

# Add a bank account to an account

`POST /v2/accounts/{account_id}/bank-account`

Adds a new bank account to an existing account.

## Path parameters

- `account_id` string, required

## Request body

- union
  - LocalBankAccount
    - `bank` object
      - `code` string, required — See `bank_codes` details from Payouts in the [Country requirements](https://docs.dlocal.com/docs/country-requirements-payouts) article.
      - `country` string, required — Bank account's country. ISO 3166-1 alpha-2 code.
      - `currency` string, required — Bank account currency. Three-letter ISO-4217 currency code, in uppercase.
      - `account_number` string, required — Bank account’s number.
      - `type` string, required — Type of account. <br><br>Possible values: `INTERNATIONAL` or `LOCAL`.
      - `branch` string — Bank account branch.
      - `account_type` string, required — Bank account’s type. <br><br>Possible values: `CHECKING`, `SAVING`, `PIX_PHONE`, `PIX_EMAIL`, `PIX_BANK_ACCOUNT`, or `PIX_DOCUMENT_ID`.
      - `swift` string — Bank account swift number.
      - `beneficiary` object
        - `name` string, required — Bank account beneficiary's first name or company name.
        - `last_name` string — Bank account beneficiary’s last name. Requested if the account’s profile is individual.
        - `document_id` string, required — Beneficiary's document ID.
        - `document_type` string, required — Beneficiary's document type.
        - `address` string, required — Beneficiary's address.
        - `phone` string, required — Beneficiary's phone number. <br><br>Length: 20.
        - `email` string — Beneficiary's email address.
  - InternationalBankAccount
    - `bank` object
      - `code` string — See `bank_codes` details from Payouts in the [Country requirements](https://docs.dlocal.com/docs/country-requirements-payouts) article.
      - `country` string, required — Bank account's country. ISO 3166-1 alpha-2 code.
      - `currency` string, required — Bank account currency. Three-letter ISO-4217 currency code, in uppercase.
      - `account_number` string, required — Bank account’s number.
      - `type` string, required — Type of account. <br><br>Possible values: `INTERNATIONAL` or `LOCAL`.
      - `branch` string — Bank account branch.
      - `account_type` string, required — Bank account’s type. <br><br>Possible values: `CHECKING`, `SAVING`, `PIX_PHONE`, `PIX_EMAIL`, `PIX_BANK_ACCOUNT`, or `PIX_DOCUMENT_ID`.
      - `swift` string, required — Bank account swift number.
      - `beneficiary` object
        - `name` string, required — Bank account beneficiary's first name or company name.
        - `last_name` string — Bank account beneficiary’s last name. Requested if the account’s profile is individual.
        - `document_id` string — Beneficiary's document ID.
        - `document_type` string — Beneficiary's document type.
        - `address` string — Beneficiary's address.
        - `phone` string — Beneficiary's phone number. <br><br>Length: 20.
        - `email` string — Beneficiary's email address.

## Response `201`

OK

- ResponseBankAccount
  - `account_id` string — User’s dLocal account ID.
  - `status` string — Bank account status. <br><br> [See details](https://docs.dlocal.com/reference/bank-status-v2-platforms).
  - `status_code` number — Bank account status code. <br><br> It could be 200 (active) or 300 (inactive)
  - `status_detail` string — Bank account status detail.
  - `creation_date` string, date — Bank account creation's timestamp. ISO-8601 - Notification’s timestamp (YYYY-MM-DDTHH:mm:ss.SSSSZ)
  - `bank_account_id` string — Bank account ID assigned by dLocal.

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/dlocal/apis/payins.md) · [All operations](https://skmtc.net/dlocal/apis/payins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dlocal/payins/revisions/d87e090020f9/schema)