PUT/DELETE /api/v1/webhooks/{id} — Update or Remove a Webhook

Once a webhook is registered, you can change its target URL, the events it listens for, or the campaign it is scoped to. Use DELETE to remove the subscription entirely.

Update a webhook

Send a PUT request to replace the webhook configuration. All body fields are accepted.

integer

required

The ID of the webhook to update.

string

required

The HTTPS endpoint that will receive event payloads.

array

required

Array of event type strings to subscribe to. Replaces the existing event list.

integer

Scope events to a specific campaign. Omit to receive events from all campaigns.

curl -X PUT "https://reachowl.com/api/v1/webhooks/1" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.example/hooks/reachowl",
    "events": [
      "contact-is-sent-a-message",
      "contact-reply-to-your-message"
    ],
    "campaign_id": 123
  }'

Delete a webhook

Send a DELETE request to permanently remove the subscription. ReachOwl stops sending payloads to the URL immediately.

curl -X DELETE "https://reachowl.com/api/v1/webhooks/1" \
  -H "Authorization: Bearer {token}"

A successful delete returns 204 No Content.

Deletion is permanent. If you want to temporarily stop receiving events, update the webhook with a narrower event list instead.

⌘I

Getting Started

Concepts

Guides

Api Reference

PUT/DELETE /api/v1/webhooks/{id} — Update or Remove a Webhook

Update a webhook

Delete a webhook

​Update a webhook

​Delete a webhook

Update a webhook

Delete a webhook