---
title: "Actualizar cuenta conectada"
method: PATCH
path: "/connected_accounts/{id}"
tags: ["connectedAccounts"]
---

# Actualizar cuenta conectada

`PATCH /connected_accounts/{id}`

Actualiza los datos comerciales, los datos fiscales y la configuración de
retiros de una cuenta conectada. Para usar retiros instantáneos, la cuenta
hija debe cumplir los requisitos de elegibilidad de Recurrente.

## Path parameters

- `id` string, required

## Headers

- `X-SECRET-KEY` string, required

## Request body

- ConnectedAccountUpdateRequest — Solo se permite actualizar el nombre comercial y la programación de retiros. - `tax_id` y `tax_name` se extraen del RTU al crear la cuenta — para corregirlos, re-`POST` con el mismo `email` y el RTU correcto. - `account_type` tampoco se acepta en update: cambiarlo invalidaría los documentos de verificación requeridos para el nuevo tipo. Re-`POST` con el `account_type` nuevo y los documentos correspondientes.
  - `name` string — Nombre comercial de la cuenta hija
  - `withdrawals_schedule` 'daily' | 'manual' | 'instant' — Frecuencia para retiros de la cuenta hija

## Response `200`

Cuenta conectada actualizada

- 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
- `404` — Cuenta conectada no encontrada

---

[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)