---
title: "Crear una cuenta conectada"
method: POST
path: "/connected_accounts"
tags: ["connectedAccounts"]
---

# Crear una cuenta conectada

`POST /connected_accounts`

Crea una cuenta administrada por tu plataforma, la conecta a tu cuenta y
marca el onboarding como completado. Si ya tienes una cuenta conectada
para el mismo `email`, Recurrente la reutiliza y actualiza sus datos
(idempotencia por email del administrador).

Recurrente extrae automáticamente el `tax_id` (NIT) y el `tax_name`
(razón social) del documento `tax_registration_document` (RTU) que envías
en `verification` — no necesitas enviarlos en el request.

Debes enviar la documentación requerida para el tipo de cuenta en
`verification`. Si faltan documentos requeridos, Recurrente responde `400`
y no completa el onboarding de la cuenta.

Puedes enviar `bank_account` para configurar de una vez la cuenta bancaria
externa que recibirá retiros. Si tu cuenta tiene pricing especial para
referidos, ese pricing se aplica a las cuentas conectadas nuevas.

Al crear o reutilizar la conexión, Recurrente emite el webhook
`account_connection.create` con los campos `parent_account` y
`child_account`.

## Headers

- `X-SECRET-KEY` string, required

## Response `201`

Cuenta conectada creada

- ConnectedAccount
  - `id` string — ID único de la cuenta conectada
  - `status` string — Estado de la cuenta
  - `name` string — Nombre comercial de la cuenta
  - `account_type` 'business' | 'individual' | 'non_profit' — Tipo de cuenta de negocio
  - `created_at` string, date-time — Fecha de creación
  - `creator_name` string — Nombre del usuario creador
  - `creator_email` string, email — Email del usuario creador
  - `tax_id` string, nullable — ID fiscal de la cuenta
  - `tax_name` string, nullable — Nombre fiscal de la cuenta
  - `withdrawals_schedule` 'daily' | 'manual' | 'instant' — Frecuencia configurada para retiros
  - `onboarding_completed` boolean — Indica si la cuenta completó onboarding

## Other responses

- `400` — Cuenta inválida

---

[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/f494a078482c/schema)