Skip to main content
Esta página cubre el API de gestión de suscripciones a webhooks. Para el formato de las entregas entrantes (headers, firmas, política de reintentos) ver la guía de Webhooks.

Listar tipos de eventos

Scope: webhooks:manage. Devuelve la lista completa de tipos de eventos a los que puedes suscribirte, más una agrupación de UI.

Response 200

Usa el objeto groups para construir un dropdown ordenado en tu UI de integración. El array events es la lista plana para validación.

Listar suscripciones

Scope: webhooks:manage. Lista las suscripciones gestionadas por el cliente que llama (solo integraciones Zapier / Make / API — las suscripciones gestionadas desde el panel quedan exclusivamente bajo el panel).

Response 200


Crear una suscripción

Scope: webhooks:manage.

Request body

Pasa siempre external_id cuando puedas — típicamente es el ID del scenario / zap / flow de tu lado. Si la suscripción ya existe para ese external_id, la llamada es idempotente y devuelve 200 con el registro existente en lugar de 409. Esto es lo que hace seguros los reintentos de Make / Zapier ante replays.

Response 201 (suscripción nueva)

El secret se devuelve solo al momento de la creación. Guárdalo — lo necesitas para verificar las firmas de los webhooks (ver Verificar la firma). Si lo pierdes, elimina la suscripción y crea una nueva.

Response 200 (replay idempotente)

Cuando el external_id ya existe para este cliente, recibes la suscripción existente con el mismo body pero sin secret. Tu secret guardado de la creación original sigue siendo válido.

Errores

  • 403 FORBIDDEN — falta el scope webhooks:manage, o se alcanzó el límite del plan para webhook endpoints.

Obtener una suscripción

Scope: webhooks:manage. Suscripción individual.

Eliminar una suscripción

Scope: webhooks:manage. Borrado duro de las suscripciones de plataformas externas.
Las suscripciones gestionadas desde el panel solo se pueden borrar desde la UI de FlowEstate — el API devuelve 403 para esos casos. Esto protege a los usuarios de que conectores de terceros eliminen accidentalmente suscripciones que no crearon.

Response 200