Elegir los eventos de un webhook

Sirve para definir a qué tipos de evento queda suscripto un endpoint.

PUT
/webhooks/endpoints/{id}/events

Escritura · requiere el permiso accounts:write.

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

id*integer

Cuerpo del pedido

application/json
  1. body

El cuerpo de PUT api/v1/webhooks/endpoints/{id}/events.

Acepta las dos formas, porque las dos son legítimas y pedirle al cliente que elija una sería gratuito:

{"events": ["device.disconnected"]} → suscribe a esos tipos, activados, y da de baja los que no estén.

{"events": [{"event_type": "device.disconnected", "enabled": false}]} → lo mismo, pero eligiendo el interruptor de cada uno. Un tipo con enabled: false queda suscripto y apagado: no se entrega, pero la configuración sobrevive a volver a prenderlo.

events*array<>
Elementositems <= 50

Cuerpo de la respuesta

application/json
  1. response
curl -X PUT "https://example.com/webhooks/endpoints/0/events" \  -H "Content-Type: application/json" \  -d '{    "events": [      {        "event_type": "device.disconnected"      }    ]  }'
{}