Webhooks

Crea un webhook entrante libre (binding task/generic)

Crea la URL entrante y, si elegiste verificación HMAC, la respuesta trae el secret: guárdalo en ese momento, es lo que necesita quien te va a llamar para firmar. Sin firma, cualquiera que descubra la URL puede disparar lo que haya detrás.

post/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

Path parameters

workspaceIdnumber required

ID numérico del workspace. Debe ser el mismo workspace de tu API key: pedir otro devuelve 401.

Request body

binding_type'generic' required

'generic' → emite el evento y ahí lo toman las automatizaciones.

Acá había también 'task', que ejecutaba una tarea directo y sembraba un task_triggers de tipo webhook.received. Se fue con el ejecutor: una tarea es un checklist que hacen personas. Los endpoints ya creados con ese binding siguen recibiendo y registrando el evento, solo que no disparan nada — para actuar sobre él, se conecta un flujo al evento.

dedupe_eventsboolean

true → deduplica reintentos por external_id (idempotencia). false (default) → cada entrega se registra y despacha. Ver migración webhook_dedupe_toggle.

descriptionstring
namestring required
signature_headerstring

Header del que se lee la firma. Default 'x-signature'.

verifier_type'hmac_sha256' | 'none' required

'hmac_sha256' → genera secret automáticamente y se devuelve UNA VEZ. 'none' → sin firma (badge inseguro en UI).

Response

successtrue required

Siempre true en una respuesta 2xx.

Example response

{
  "data": {
    "binding_type": "generic",
    "created_at": "2026-07-30T04:12:33.120Z",
    "created_by": 77,
    "description": "Avisos de la plataforma de e-commerce",
    "enabled": true,
    "field_mappings": [
      {
        "dest_key": "email",
        "dest_kind": "contact",
        "fallback": "sin dato",
        "json_path": "data.customer.email",
        "on_existing": "fill"
      }
    ],
    "id": 91,
    "name": "Pedidos de la tienda",
    "secret": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
    "signature_header": "x-signature",
    "slug": "k3f9x2mq7rt1vb8z",
    "updated_at": "2026-07-30T04:12:33.120Z",
    "verifier_type": "hmac_sha256",
    "workspace_id": 134
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.