Calendly Api

When to Use This Skill

USE when:

• Automating interview scheduling workflows
• Building meeting booking integrations
• Creating round-robin scheduling systems
• Tracking scheduled events programmatically
• Integrating calendars with CRM systems
• Building appointment reminders
• Creating custom booking confirmation flows
• Automating follow-up sequences after meetings
• Syncing Calendly with external calendars
• Building scheduling analytics dashboards

DON'T USE when:

• Simple calendar display (use Google Calendar API)
• Real-time video calls (use Zoom/Teams API)
• Complex resource scheduling (use specialized tools)
• Internal meeting coordination only (use calendar apps)
• One-off manual scheduling (use Calendly UI directly)

Prerequisites

Calendly API Setup

# 1. Get API credentials at https://calendly.com/integrations/api_webhooks
# 2. Create a Personal Access Token or OAuth app
# 3. Note: API v2 requires organization-level access for some endpoints

# Personal Access Token:
# - Go to Integrations > API & Webhooks
# - Generate a new token
# - Copy the token (shown only once)


*See sub-skills for full details.*
### Python Environment Setup

```bash
# Create virtual environment
python -m venv calendly-env
source calendly-env/bin/activate  # Linux/macOS
# calendly-env\Scripts\activate   # Windows

# Install dependencies
pip install requests python-dotenv httpx aiohttp

# Create requirements.txt

*See sub-skills for full details.*
### API Client Setup

```python
# client.py
# ABOUTME: Calendly API client with authentication
# ABOUTME: Handles requests, pagination, and error handling

import os
import requests
from typing import Optional, Dict, Any, List
from dotenv import load_dotenv


*See sub-skills for full details.*

## Version History

| Version | Date | Changes |
|---------|------|---------|
| 1.0.0 | 2026-01-17 | Initial release with comprehensive Calendly API v2 patterns |

## Resources

- [Calendly API Documentation](https://developer.calendly.com/api-docs)
- [Calendly Developer Portal](https://developer.calendly.com/)
- [OAuth 2.0 Guide](https://developer.calendly.com/getting-started-with-oauth)
- [Webhooks Guide](https://developer.calendly.com/api-docs/4e4e9a77ef8bc-webhooks)
- [Rate Limits](https://developer.calendly.com/api-docs/rate-limiting)
- [API Changelog](https://developer.calendly.com/api-changelog)

---

*This skill provides production-ready patterns for Calendly scheduling automation, enabling seamless meeting coordination and booking workflows.*

## Sub-Skills

- [1. User and Organization Management](1-user-and-organization-management/SKILL.md)
- [2. Event Types](2-event-types/SKILL.md)
- [3. Scheduled Events](3-scheduled-events/SKILL.md)
- [4. Invitees](4-invitees/SKILL.md)
- [5. Webhooks](5-webhooks/SKILL.md)
- [6. Scheduling Links and Routing](6-scheduling-links-and-routing/SKILL.md)
- [Slack Notification Integration](slack-notification-integration/SKILL.md)
- [GitHub Actions Integration](github-actions-integration/SKILL.md)
- [1. Rate Limiting (+3)](1-rate-limiting/SKILL.md)
- [Common Issues (+1)](common-issues/SKILL.md)