Register a webhook endpoint
Registers a new HTTPS endpoint to receive scheduling events. Requires the Business plan or above. The signing secret is returned once and cannot be retrieved again — store it securely. URLs are validated for HTTPS scheme and checked against private/link-local/loopback/reserved address ranges before the endpoint is created.
Request
- Base URL: https://api.wondercal.com
- URL: https://api.wondercal.com/api/webhooks
- Auth: HTTP bearer
Headers
Optional idempotency key (max 255 chars). When provided, retrying the same request within 24 hours with the same key and identical body returns the cached response instead of re-executing. Do not embed sensitive data in the key value — keys may appear in server logs on certain error paths. Use a distinct key per endpoint call — the key is scoped to your user account only, not to the endpoint URL, so reusing the same key across different endpoint calls may return an incorrect cached response.
Request body
Example request
{
"url": "https://api.example.com/webhooks/wondercal"
}Response
Webhook endpoint created
Changes
No recorded changes to this operation across all 1 revision of this API.