put
https://api.neutron.me/api/v2/webhook/
Update the webhook for the authenticated account
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
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
Unauthorized - Invalid or missing authentication credentials
Not Found - The requested webhook does not exist