This endpoint changes the options of one webhook endpoint of the company: its signature mode and
whether it skips empty booking.updated events. Only the options sent change. The URL, the events
and the secret are changed from the AgendaPro web app; other fields in the body are ignored.
Important Notes
-
Requires
webhooks:writescope. -
signature_mode:legacy,dualorstandard(see Webhooks › Signature). The legacy
signature is deprecated, so we recommend migrating: move an endpoint inlegacytodual
once your receiver verifies the standard signature, then tostandard. -
The signature mode moves one step at a time, so every change keeps a signature your receiver
already verifies:From To legacyTo dualTo standardlegacyno change allowed 422 restricted/signature_modedualallowed (rollback) no change allowed standard422 restricted/signature_modeallowed (rollback) no change Sending the current mode changes nothing.
skip_empty_updatescan be changed alone, in any
mode. When the request is rejected, nothing in it is applied. -
skip_empty_updates:truestops thebooking.updatedevents whosechangesis empty or
holds onlyupdated_at(see Webhooks › When an*.updatedevent is sent). Off by default. -
The change applies to the deliveries signed after it; a retry of an earlier message is signed
again with the current mode. -
An endpoint of another company, a deleted one or an unknown id answers 404.
Errors Dictionary
| Status | Error | Detail | Description |
|---|---|---|---|
| 400 | invalid_format | signature_mode | signature_mode is not legacy, dual or standard. |
| 400 | invalid_format | skip_empty_updates | skip_empty_updates is not a JSON boolean. |
| 400 | invalid_body | expected_object | The body is not a JSON object. |
| 401 | unauthorized | invalid_api_key | Missing or invalid Bearer token. |
| 401 | unauthorized | api_config_inactive | API access is inactive for this company. |
| 403 | forbidden | scope_denied | API key lacks webhooks:write scope. |
| 404 | not_found | webhook_endpoint | The endpoint does not exist, was deleted or belongs to another company. |
| 422 | restricted | signature_mode | The change skips a step: legacy → standard or standard → legacy (go through dual). |
| 429 | rate_limited | burst_limit_exceeded | Per-minute request limit exceeded. |
| 429 | rate_limited | daily_quota_exceeded | Daily request quota exceeded. |
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
