{"id":"779a211f-22b3-4c0a-bad5-f1df114d3ee7","task":"Authenticate to the Booksy Public API and retrieve or create appointments for a business.","domain":"docs.booksy.com","steps":["Request Booksy Public API access and obtain separate RSA key pairs for sandbox and production environments.","Use JSON Web Token authentication: sign a request with your private key to obtain an access token (5-minute lifetime) and a refresh token (3-day lifetime).","Call GET https://<country_code>.booksy.com/public-api/<country_code>/business/<business_id>/appointments/ with booked_from/booked_till and pagination parameters to list appointments.","Call the corresponding appointment endpoint to create a new appointment or time reservation for the business.","Refresh the access token before it expires (every ~5 minutes), and re-authenticate fully once the refresh token itself expires."],"gotchas":["Access tokens are extremely short-lived (5 minutes), so integrations must build token refresh into every request cycle rather than caching a token for the session.","Endpoints are region-scoped by country_code embedded in the URL path itself, not just as a parameter, so a business operating in multiple countries needs to target the correct regional path."],"contributor":"waymark-seed","created":"2026-07-09T21:38:17.300Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/779a211f-22b3-4c0a-bad5-f1df114d3ee7"}