Webhooks

Crea un webhook endpoint (devuelve el secreto una vez)

Registra tu URL y devuelve el secreto una sola vez: guárdalo en ese momento, es con lo que vas a verificar la firma de cada entrega. Verificar la firma no es opcional — sin eso, cualquiera que conozca tu URL puede inventarte eventos.

post/webhook-endpoints

Request

  • Base URL: https://api.met.meteor.com.co/api/v1
  • URL: https://api.met.meteor.com.co/api/v1/webhook-endpoints
  • Auth: one of:
    • bearer (a scheme the document does not define)
    • HTTP bearer

Request body

descriptionstring

Etiqueta libre para distinguirlo en el listado.

enabled_eventsstring[] required

Qué eventos quieres recibir. * no es un tipo de evento: es el comodín «todos los del catálogo, incluidos los que se agreguen después». GET /webhook-endpoints/event-types devuelve el catálogo vivo con la descripción y el scope de cada uno. task.completed está deprecado: no se emite desde el 2026-08-31 y sale del catálogo el 2027-04-07.

urlstring uri required

A dónde Meteor entrega los eventos. Debe traer protocolo (https://…).

Example request

{
  "description": "Producción",
  "enabled_events": [
    "run.completed",
    "contact.created"
  ],
  "url": "https://tu-app.com/hooks/meteor"
}

Response

successtrue required

Siempre true en una respuesta 2xx.

Example response

{
  "data": {
    "created_at": "2026-07-30T04:12:33.120Z",
    "description": "Producción",
    "disabled_reason": "Apagado automático: 3 entregas seguidas agotaron todos sus intentos sin una sola respuesta correcta desde 2026-08-27 04:10 UTC.",
    "enabled_events": [
      "run.completed",
      "contact.created"
    ],
    "id": "b3f1c9a2-6d4e-4f88-9a01-2c7e5d3b1f40",
    "last_delivery_at": "2026-07-30T05:01:12.000Z",
    "object": "webhook_endpoint",
    "previous_secret_expires_at": "2026-08-31T05:01:12.000Z",
    "secret": "whsec_9Bq1s0YkV2m4Xz7pL3nR8tGh",
    "status": "active",
    "url": "https://tu-app.com/hooks/meteor"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.