---
title: "Cuenta conectada creada"
method: POST
path: "account-connection-create-webhook"
---

# Cuenta conectada creada

`POST account-connection-create-webhook` (webhook)

Se emite cuando una cuenta hija se conecta a una cuenta padre. La cuenta
padre recibe el evento por su propia actividad de conexión. Si esa
cuenta padre también es hija de otra cuenta con webhooks habilitados, el
evento se reenvía como evento de cuenta conectada con `connected: true`
y `account_id`.

## Payload

- AccountConnectionWebhook
  - `id` string, required — ID único de la conexión entre cuentas
  - `event_type` 'account_connection.create', required — Tipo de evento webhook
  - `status` 'active', required — Estado de la conexión
  - `api_version` string, required — Versión del payload webhook
  - `created_at` string, date-time, required — Fecha de creación de la conexión
  - `live_mode` boolean, required — Indica si el evento corresponde a producción
  - `connected` boolean, nullable — Presente como `true` cuando el evento se reenvía a una cuenta padre upstream.
  - `account_id` string, nullable — ID de la cuenta conectada que generó el evento cuando `connected` es `true`.
  - `parent_account` ConnectedAccount, required
    - `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
  - `child_account` ConnectedAccount, required
    - `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

## Acknowledgement `200`

Webhook received successfully

---

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