YouCanBookMe (Public)
Integrate your application with the unauthenticated YouCanBookMe booking API
🚀 Quickstart
Connect to YouCanBookMe's public booking API with Tenklo — no credentials required beyond your booking page's subdomain.
In Tenklo (free signup), go to Integrations -> Configure New Integration -> YouCanBookMe (Public).
Authorize YouCanBookMe (Public)
Go to Connections -> Add Test Connection -> Authorize, then enter your booking page subdomain. Later, you'll let your users do the same directly from your app.
Let's make your first request to the YouCanBookMe API (create a booking intent). Replace the placeholders below with your Environment API key, integration ID, connection ID, and your subdomain:
curl "https://api.tenklo.dev/proxy/v1/intents" \
-X POST \
-H "Authorization: Bearer <NANGO-API-KEY>" \
-H "Provider-Config-Key: <INTEGRATION-ID>" \
-H "Connection-Id: <CONNECTION-ID>" \
-H "Content-Type: application/json" \
-d '{
"subdomain": "<YOUR-SUBDOMAIN>"
}'Or fetch the connection's subdomain with the Node SDK or API.
✅ You're connected! Check the Logs tab in Tenklo to inspect requests.
Follow our Auth implementation guide to integrate Tenklo in your app.
📚 YouCanBookMe (Public) integration guides
Nango-maintained guides for common use cases.
- How do I link my account? Finding your booking page subdomain
Official docs: YouCanBookMe API docs
🧩 Pre-built syncs & actions for YouCanBookMe (Public)
Explore Nango-provided actions in your dashboard. Extend and customize them to fit your needs.
Others
| Function name | Description | Type | Source code |
|---|---|---|---|
create-booking-intent | Start a new booking session (intent) against a YouCanBook.me booking page, scoped by subdomain. | Action | 🔗 Github |
get-availability-key | Get a short-lived key representing the searchable availability window for a booking intent, to be passed to get-available-slots. | Action | 🔗 Github |
get-available-slots | Get the list of open time slots for a booking intent's search window. | Action | 🔗 Github |
get-booking-intent | Get the current state of a booking intent (selections made so far, status, resulting bookingId once confirmed). | Action | 🔗 Github |
update-booking-intent-selections | Set the chosen time slot, contact/form details, timezone, and other booking options on an in-progress intent | Action | 🔗 Github |
API gotchas
- There is no authentication for this API — the booking-intent endpoints (availability, booking, cancellation, rescheduling) are public. For the authenticated/admin side of the API (e.g.
/v1/profiles), use the separate YouCanBookMe integration, which uses Basic auth (Account ID + API key).