Update an existing webhook's callback URL, secret, or both.

Example Request

curl -X PUT https://api.neutron.me/api/v2/webhook/01e2a3dc-0c34-4e14-92e4-b270c4778d95 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "callback": "https://yourapp.com/webhooks/v2/neutron",
    "secret": "new-webhook-secret"
  }'

Request Body

Field	Type	Required	Description
`callback`	string	❌	New callback URL
`secret`	string	❌	New secret for signature verification

You can update either field independently or both at once.

Common Use Cases

Scenario	Update
Migrating to a new server	Change `callback` URL
Rotating secrets	Change `secret` (update your verification code to match)
Moving to a new endpoint version	Change `callback` to `/v2/webhooks`

Important

After updating the secret, immediately update your server's verification code to use the new secret — events sent after the update will be signed with the new secret
Get your webhook ID from List Webhooks if you don't have it

Related

List Webhooks — Get your webhook ID
Remove Webhook — Delete the webhook entirely
Webhook Guide — Setup and signature verification