Troubleshooting
The widget does not render
- CSP: allow
https://devalender.cominscript-srcandconnect-src; see Frameworks and CSP. - Script loaded twice: include
widget.jsonce per page. Loading it twice can leave the elements blank or duplicated. - SSR: the elements are custom elements and only upgrade in the browser. In a framework, load the script on the client, as shown in Frameworks and CSP.
Times show in the wrong timezone
Instants are UTC, and slots are grouped by day in the tz you pass. Pass an IANA name such as Europe/Berlin; without it the host's timezone is used. See timezones.
Slot taken (409, exit code 4)
Someone booked that slot first, or the session is full. The API answers 409 and the CLI exits with code 4. Fetch fresh slots and book another.
Webhook returns 401
Your server rejected the delivery. Verify against the raw request body, not re-serialized JSON, and use the whsec_ secret of this endpoint. A rotated secret invalidates the old one. See Verify the signature.
Webhook returns 400 stale
The t in the signature is more than 5 minutes from your clock. Fix clock skew on your server (use NTP).
Google says "needs reconnect"
Reconnect in settings; see Reconnect.
Rate limits
Some public endpoints answer 429 with rate_limited. Back off and retry later. See errors.