---
title: "Crear una cuenta bancaria"
method: POST
path: "/bank_accounts"
tags: ["bankAccounts"]
---

# Crear una cuenta bancaria

`POST /bank_accounts`

Registra una cuenta bancaria externa como destino de retiro. Usa `GET /banks` para los valores válidos de `bank_name`. Las cuentas son inmutables salvo `is_preferred` — archiva y crea una nueva para cambiar otros datos.

## Headers

- `X-SECRET-KEY` string, required

## Request body

- object
  - `holder_name` string, required
  - `number` string, required
  - `bank_name` string, required
  - `currency` 'GTQ' | 'USD', required
  - `account_type` 'checking' | 'savings', required
  - `is_preferred` boolean

## 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` — Error de validación o banco desconocido

---

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