Ingresar
DocumentaciónGuíasReferenciaWebhooksRecursos
Endpoints de webhooks (sistema anterior)

Ver un webhook

Usalo para ver la configuración de un endpoint: URL, eventos, estado, motivo de desactivación y cuándo se rotó el secreto.

GET
/webhooks/endpoints/{id}

Lectura · requiere el permiso accounts:read.

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

id*integer

Cuerpo de la respuesta

WebhookEndpointResource

application/json
  1. response
id*integer
url*string
description*string|null
status*string
disabled_reason*string|null
events?array<>
health*
secret_rotated_at*string|null
created_at*string|null
updated_at*string|null
curl -X GET "https://example.com/webhooks/endpoints/0"
{  "id": 0,  "url": "string",  "description": "string",  "status": "string",  "disabled_reason": "string",  "events": [    {      "event_type": "string",      "enabled": true    }  ],  "health": {    "consecutive_failures": 0,    "last_delivery_at": "string",    "last_success_at": "string"  },  "secret_rotated_at": "string",  "created_at": "string",  "updated_at": "string"}

Crear un webhook POST

Sirve para que tu sistema se entere cuando un número se conecta o se desconecta, sin consultar la API. Registrá una URL HTTPS y guardá el secreto: se muestra una sola vez.

Actualizar un webhook PATCH

Sirve para cambiar la URL o la descripción de un endpoint, o para prenderlo y apagarlo entero sin perder sus suscripciones.