---
title: "Lista webhooks entrantes del workspace"
method: GET
path: "/workspaces/{workspaceId}/webhooks"
tags: ["Webhooks"]
---

# Lista webhooks entrantes del workspace

`GET /workspaces/{workspaceId}/webhooks`

## Request

- Base URL: `https://api.met.meteor.com.co/api/v1`
- URL: `https://api.met.meteor.com.co/api/v1/workspaces/{workspaceId}/webhooks`
- Auth: one of:
  - `bearer` (a scheme the document does not define)
  - HTTP bearer

Los webhooks entrantes del workspace: las URLs que expones para que un sistema externo te avise de algo. Es la dirección contraria a los webhooks salientes de `/outbound-webhooks`, que son los que Meteor te llama a ti.

## Path parameters

- `workspaceId` number, required

## Response `200`

- object: Sobre en el que viaja toda respuesta correcta de la API. El recurso está en `data`. Los SDKs oficiales lo desenvuelven por ti; un cliente hecho a mano tiene que leer `.data`.
  - `success` true, required: Siempre `true` en una respuesta 2xx.
  - `data` InboundWebhookListItemDto[], required
    - `binding_target` object, nullable, required: A qué apunta el binding. `{ "task_id": 17 }` para `task`, `{ "mcp_key": "mercadopago", "workspace_mcp_id": 42 }` para `mcp`, `null` para `generic`.
    - `binding_type` 'mcp' | 'task' | 'generic', required: Qué hace Meteor al recibir un evento: `task` ejecuta una tarea, `generic` solo lo registra y emite el evento, `mcp` pertenece a una integración (esos no se crean ni se borran por esta API).
    - `connected_flow` ConnectedFlowDto, required
      - `id` string, required
      - `name` string, required
    - `created_at` string, required
    - `dedupe_events` boolean: `true` = el mismo `external_id` entra una sola vez, para que un reintento del proveedor no dispare la tarea dos veces.
    - `description` string, nullable, required
    - `enabled` boolean, required: `false` = el endpoint responde pero no procesa nada.
    - `field_mappings` WebhookFieldMappingDto[], nullable: Mapeo de payload → campos. Solo en el detalle y al guardar el mapeo.
      - `dest_key` string, required: `field_key` del contacto o nombre de la variable, según `dest_kind`.
      - `dest_kind` 'contact' | 'workspace_var', required: Si el destino es un campo del contacto o una variable del workspace.
      - `fallback` string, nullable: Valor a usar cuando `json_path` no viene en el payload.
      - `json_path` string, required: Ruta JSON dentro del cuerpo recibido.
      - `on_existing` 'fill' | 'overwrite': `fill` conserva un valor existente; `overwrite` deja que este mapeo lo actualice. Omitido equivale a `fill`.
    - `id` number, required
    - `link_contact` boolean: `true` = el mapeo resuelve (o crea) el contacto cuando el payload trae teléfono, correo o `user_ns`.
    - `name` string, required
    - `paused_at` string, nullable: Cuándo Meteor pausó el endpoint sola por superar su techo diario. `null` si no está pausado.
    - `paused_reason` string, nullable: Por qué se pausó. `null` si no está pausado.
    - `recent_events_24h` number, required: Cuántos eventos entraron en las últimas 24 horas.
    - `signature_header` string, required: Cabecera de la que se lee la firma HMAC, siempre en minúsculas.
    - `slug` string, required: Parte opaca de la URL pública de recepción. No lleva el `workspace_id`, para que nadie pueda enumerar endpoints ajenos.
    - `updated_at` string, required
    - `verifier_type` 'mcp_native' | 'hmac_sha256' | 'none', required: Cómo se verifica que el evento venga de quien dice.

## Other responses

- `400`: La request no es válida: un campo no pasa validación, falta un parámetro requerido o el recurso no admite la transición solicitada.
- `401`: API key ausente, inválida, revocada o expirada — o el workspace está bloqueado.
- `403`: La key está autenticada pero no puede ejecutar esta operación: scope faltante, capacidad deshabilitada, modo test restringido o recurso fuera de su cartera.
- `404`: El recurso no existe o no está disponible dentro del alcance de la key. No revela la existencia de recursos de otros tenants.
- `429`: Se superó el límite por minuto de la key o la cuota del plan. Respeta `Retry-After`; el SDK ya reintenta solo.
- `500`: Error del servidor o del Met que ejecutaba. El SDK reintenta los 5xx con backoff.

---

[API](https://skmtc.dev/meteor/apis/met-public-api.md) · [All operations](https://skmtc.dev/meteor/apis/met-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meteor/apis/met-public-api/revisions/5d9ca294295c?raw)