---
title: "Crear cuenta bancaria conectada"
method: POST
path: "/connected_accounts/{connected_account_id}/bank_accounts"
tags: ["connectedAccounts"]
---

# Crear cuenta bancaria conectada

`POST /connected_accounts/{connected_account_id}/bank_accounts`

## Request

- Base URL: `https://app.recurrente.com/api`
- URL: `https://app.recurrente.com/api/connected_accounts/{connected_account_id}/bank_accounts`
- Auth: API key in header `X-SECRET-KEY`
- TypeScript: <https://skmtc.dev/recurrente/apis/referencia-api/docs/connected_accounts/:connected_account_id/bank_accounts/post.ts> (a function with typed inputs; its response is checked against the schema)

Crea una cuenta bancaria externa para una cuenta conectada. Recurrente la
usa como destino de retiros según la configuración de la cuenta hija.

## Path parameters

- `connected_account_id` string, required

## Request body

- BankAccountCreateRequest
  - `holder_name` string, required: Nombre del titular de la cuenta
  - `number` string, required: Número de cuenta bancaria
  - `bank_name` string, required: Nombre del banco. La comparación es case-insensitive. Si el nombre no coincide con un banco soportado, Recurrente responde `400` con la lista de bancos válidos. Consulta `GET /api/banks` para obtener la lista actualizada.
  - `currency` 'GTQ' | 'USD', required: Moneda de la cuenta bancaria
  - `account_type` 'checking' | 'savings': Tipo de cuenta bancaria
  - `is_preferred` boolean: Enviar `true` para dejar esta cuenta bancaria como predeterminada para retiros en su moneda

## Response `201`

Cuenta bancaria creada

- BankAccount
  - `id` string: ID único de la cuenta bancaria
  - `bank_name` string, nullable: Nombre del banco
  - `holder_name` string: Nombre del titular
  - `created_at` string, date-time: Fecha de creación
  - `status` 'active' | 'archived': Estado de la cuenta bancaria
  - `currency` 'GTQ' | 'USD': Moneda de la cuenta bancaria
  - `account_type` 'checking' | 'savings': Tipo de cuenta bancaria
  - `is_preferred` boolean: Indica si es la cuenta preferida para su moneda
  - `ownership_type` 'external' | 'virtual': Tipo de cuenta bancaria

## Other responses

- `400`: Cuenta bancaria inválida
- `404`: Cuenta conectada no encontrada

## Changes

- **2026-09-19** `33bad9197d59`: 2 breaking
  - added `#/components/schemas/ErrorErrors0` to the `errors` response property `oneOf` list for the response status `400`
  - the `errors/oneOf[subschema #1 -> subschema #2]/` response's property type changed from `object` to `array` for status `400`
- **2026-09-17** `3d76463f9fd8`: 1 warning, 1 info
  - deleted the `header` request parameter `X-SECRET-KEY`
  - the endpoint scheme security `secretKey` was added to the API
- **2026-09-12** `3f07af5cbba7`: 1 info
  - api operation id `create-connected-account-bank-account` removed and replaced with `connectedAccounts_createConnectedAccountBankAccount`

[Operation history](https://skmtc.dev/recurrente/apis/referencia-api/changes/connected_accounts/:connected_account_id/bank_accounts/post.md)

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) - [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recurrente/apis/referencia-api/revisions/1a3fc480dd94?raw)