Documentation Index
Fetch the complete documentation index at: https://docs.voxworks.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Calendly integration allows your assistant to:- Check available time slots from your Calendly calendar
- Book appointments directly into Calendly
- Cancel existing bookings
Setup
1. Get Your Calendly API Token
- Log in to your Calendly account
- Go to Integrations > API & Webhooks
- Click Generate New Token under Personal Access Tokens
- Give your token a name (e.g., “Voxworks Integration”)
- Copy the token — you won’t be able to see it again
2. Connect in Voxworks
- Navigate to Integrations in your Voxworks team dashboard
- Find Calendly and click Connect
- Paste your Personal Access Token
- Save the integration
Getting Your Event URL
Each Calendly event type has its own URL. You’ll need this when configuring the Calendly - Get Availabilities tool. To find your event URL:- Log in to Calendly
- Go to Event Types
- Click on the event you want to use
- Copy the URL from your browser or click Copy Link
https://calendly.com/your-username/event-name
For example:
https://calendly.com/acme-sales/30minhttps://calendly.com/acme-sales/discovery-call
Available Tools
| Tool | Description |
|---|---|
| Calendly - Get Availabilities | Get available time slots from Calendly |
| Calendly - Book Time | Book an appointment in Calendly |
| Calendly - Cancel Booking | Cancel an existing Calendly booking |
Best Practices
- Use specific event types — Create dedicated Calendly events for different appointment types
- Set buffer times — Configure buffer times in Calendly to prevent back-to-back bookings
- Keep tokens secure — Never share your Personal Access Token
- Monitor token expiry — Regenerate tokens if they expire or are compromised
Troubleshooting
| Issue | Solution |
|---|---|
| ”Invalid API token” | Regenerate your token in Calendly and reconnect |
| ”No availability found” | Check your Calendly availability settings and date range |
| ”Event not found” | Verify the event URL is correct and the event is active |
| ”Booking failed” | Ensure the time slot is still available (race condition) |
Next Steps
- Calendly - Get Availabilities — Check calendar availability
- Calendly - Book Time — Book appointments
- Integrations Overview — See all integrations