Webhooks

Update a webhook

patch/client/webhooks/{id}

Update one or more fields on an existing webhook.

Authorization

Bearer token in the Authorization header.

Path parameters

idstringrequired

Body required

urlstring

eventsstring[]

statusstring

Options: activeinactivefailed

secretstring

Rotate the signing secret

Response

idstringrequired

organizationIdstringrequired

urlstringrequired

eventsstring[]required

statusstringrequired

Options: activeinactivefailed

createdAtstringrequired

updatedAtstringrequired

curl -X PATCH 'https://api.lira.com/api/v1/client/webhooks/{id}' \ -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "url": "https://yourapp.com/webhooks/lira-v2", "events": [ "verification.completed" ], "status": "inactive", "secret": "whsec_newRotatedSecretValue123" }'

const response = await fetch('https://api.lira.com/api/v1/client/webhooks/{id}', { method: 'PATCH', headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', 'Content-Type': 'application/json', }, body: JSON.stringify({ "url": "https://yourapp.com/webhooks/lira-v2", "events": [ "verification.completed" ], "status": "inactive", "secret": "whsec_newRotatedSecretValue123" }), }); const data = await response.json();

import requests response = requests.patch( "https://api.lira.com/api/v1/client/webhooks/{id}", headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"}, json={ "url": "https://yourapp.com/webhooks/lira-v2", "events": [ "verification.completed" ], "status": "inactive", "secret": "whsec_newRotatedSecretValue123" }, ) data = response.json()

{ "id": "b8c9d0e1-f2a3-4567-bcde-890123456789", "organizationId": "d4e5f6a7-b8c9-0123-defa-456789012345", "url": "https://yourapp.com/webhooks/lira", "events": [ "verification.completed", "verification.failed" ], "status": "active", "createdAt": "2026-04-22T10:15:30.000Z", "updatedAt": "2026-04-22T10:15:30.000Z" }

{ "message": "NG Account Number verification is not enabled for your organisation.", "code": "SERVICE_NOT_ENABLED", "action": { "type": "CONTACT_ADMIN", "hint": "Ask your administrator to enable NG Account Number verification in the Lira dashboard." } }