Skip to main content
PUT
cURL

What this endpoint is for

Change an existing webhook without re-registering it. Send only the fields you want to change.

What you can change

  • url — move deliveries to a different endpoint
  • events — replace the list of subscribed events
  • is_active — set to false to pause deliveries, and back to true to resume
The signing secret does not change when you update a webhook, so your receiving endpoint keeps working.

Pausing instead of deleting

Set is_active to false while you deploy or debug your receiver. Novacal stops sending deliveries but keeps the webhook and its secret intact.

Access

You can only update webhooks registered on your own account. Updating another account’s webhook returns 403 access_denied.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
integer
required

ID of the webhook to update

Body

application/json

Webhook fields to update

url
string

A new target URL for deliveries

Example:

"https://example.com/hooks/novacal-v2"

events
enum<string>[]

Replaces the subscribed events

Minimum array length: 1
Available options:
event.created,
event.rescheduled,
event.canceled
Example:
is_active
boolean

Set to false to pause deliveries without deleting the webhook

Example:

false

Response

200 - application/json

Webhook updated

success
boolean
required

Indicates whether the request was successful

Example:

true

data
object
required