Skip to content
Docs

Troubleshooting

The widget does not render

  • CSP: allow https://devalender.com in script-src and connect-src; see Frameworks and CSP.
  • Script loaded twice: include widget.js once 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.