Ganchos web
Actualizar webhook
Actualice la URL, los eventos o el estado sin cambiar el secreto.
PATCH
/webhooks/{id}webhooks:writeCOMPORTAMIENTO
El cambio se valida y persiste en la cuenta clave antes de responder. Consulta el recurso devuelto como fuente de verdad.
EFECTO
Puede cambiar el recurso y emitir el evento de dominio correspondiente.
REPETICIÓN
En caso de falla de la red, confirme el estado del recurso antes de volver a intentarlo. Rehaga automáticamente solo 429 y 5xx con retroceso y fluctuación.
Solicitar
idstring · pathIdentificador de recursos.minLength 2 · maxLength 100obligatorionamestring · bodyNombre.opcionalurlstring · bodyURL HTTPS pública.uriopcionaleventsarray · bodyEventos o *.opcionalactiveboolean · bodyActiva el destino.opcionalAuthorization
Bearer ach_live_...Accept
application/jsonAlcance
webhooks:writeEjemplo ejecutable
curl
curl -X PATCH 'https://achadu.com/api/v1/webhooks/resource_id' \
-H 'Authorization: Bearer ach_live_...' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
--data '{
"name": "My integration",
"url": "https://example.com/product",
"events": [
"offer.created"
]
}'Respuesta y errores
Cada respuesta incluye request_id. Las listas añaden paginación; Los recursos mutables devuelven el estado persistente después de la operación.
200 application/json
{
"data": {
"id": "wh_01J...",
"name": "Production",
"url": "https://example.com/webhooks/achadu",
"events": [
"offer.created"
],
"active": true,
"created_at": "2026-08-31T18:20:00.000Z"
},
"request_id": "req_01J..."
}200Operación completada.400Parámetro, cuerpo o transición no válidos.401Clave faltante, inválida, caducada o revocada.402El plan de cuenta no libera esta interfaz.403A chave precisa do escopo webhooks:write.404La característica no existe en esta cuenta.409El estado actual impide esta operación.413El cuerpo JSON supera los 128 KB.429Se ha superado la ventana de 120 solicitudes por minuto.