Skip to main content

​
Overview

What it does

Calendly integration connects AI tools directly to your Calendly account, enabling natural language interactions with scheduling, events, invitees, and booking links.Key Features:
  • Manage scheduled events
  • Create and track invitees
  • Generate booking links
  • Configure event types
  • Handle no-shows
  • Manage webhooks
  • Access user and organization data
  • Create one-off event types

Use Cases

Scheduling Management:
  • View and cancel upcoming events
  • Track meeting attendance
  • Generate custom booking links
  • Create temporary event types
Invitee Tracking:
  • Monitor invitee details
  • Mark and manage no-shows
  • Handle data deletion requests
  • Track booking history
Automation:
  • Create scheduling links programmatically
  • Set up webhook notifications
  • Integrate with CRM systems
  • Automate follow-up workflows

​
Quick Start

1

Connect Your Calendly Account

NimbleBrain Studio uses OAuth2 to securely connect to your Calendly account.
  1. Navigate to Connections in the sidebar
  2. Click Browse Catalog
  3. Search for “Calendly”
  4. Click Install
  5. Click Connect and authorize with your Calendly account
  6. Grant the requested permissions
OAuth2 provides secure, token-based authentication. You’ll need to authorize access to your Calendly data.
2

Verify Connection

Once connected, test the integration:
"Show me my upcoming Calendly events"
Other test prompts:
  • “Get my Calendly profile information”
  • “Create a single-use booking link for a 30-minute meeting”
  • “Show details for my last scheduled event”

​
Available Tools

The Calendly connection provides 42+ tools organized into the following categories:

​
Event Management

View, manage, and cancel scheduled events.
ToolDescription
CALENDLY_GET_EVENTRetrieve specific event details by UUID
CALENDLY_CANCEL_EVENTCancel a scheduled event with optional reason
CALENDLY_CREATE_ONE_OFF_EVENT_TYPECreate temporary event types for unique meetings
CALENDLY_DELETE_SCHEDULED_EVENT_DATADelete event data (enterprise feature)
Example Usage:
"Cancel my meeting with John Smith scheduled for tomorrow and include the reason 'rescheduling'"
One-off event types are useful for unique meetings outside your regular availability patterns.

​
Invitee Management

Track and manage event invitees and attendance.
ToolDescription
CALENDLY_GET_EVENT_INVITEEGet detailed information about a specific invitee
CALENDLY_CREATE_INVITEE_NO_SHOWMark an invitee as absent from an event
CALENDLY_GET_INVITEE_NO_SHOWRetrieve no-show record details
CALENDLY_DELETE_INVITEE_NO_SHOWRemove no-show status from an invitee
CALENDLY_DELETE_INVITEE_DATAPermanently delete invitee data (GDPR compliance)
Example Usage:
"Mark the invitee from yesterday's 2pm meeting as a no-show"
DELETE_INVITEE_DATA is an enterprise feature for GDPR/privacy compliance. This action is irreversible.

​
Event Types

Access and manage event type configurations.
ToolDescription
CALENDLY_GET_EVENT_TYPERetrieve event type details and settings
CALENDLY_CREATE_ONE_OFF_EVENT_TYPECreate temporary event types
Example Usage:
"Show me the configuration for my 'Initial Consultation' event type"

​
User & Organization

Access user and organization information.
ToolDescription
CALENDLY_GET_CURRENT_USERGet authenticated user profile information
CALENDLY_GET_ORGANIZATION_MEMBERSHIPRetrieve organization membership details
CALENDLY_GET_ORGANIZATION_INVITATIONAccess pending organization invitations
Example Usage:
"Show me my Calendly account information"

​
Groups

Manage team groups and relationships.
ToolDescription
CALENDLY_GET_GROUPRetrieve group attributes and settings
CALENDLY_GET_GROUP_RELATIONSHIPGet user-group association details
Example Usage:
"Show me the members of our Sales team group"

​
Webhooks

Set up and manage event notifications.
ToolDescription
CALENDLY_CREATE_WEBHOOK_SUBSCRIPTIONCreate webhook subscriptions for event notifications
CALENDLY_DELETE_WEBHOOK_SUBSCRIPTIONRemove existing webhook subscriptions
Example Usage:
"Set up a webhook to notify our CRM when new events are scheduled"
Webhooks enable real-time integrations with external systems like CRMs, notification services, and automation platforms.

​
Example Workflows

Scenario: Create a booking link for a prospectPrompt:
"Create a single-use scheduling link for my 30-minute demo event type and send it to [email protected]"
What happens:
  • Creates one-time booking link
  • Link expires after first use
  • Returns shareable URL

​
Authentication

OAuth2 Authentication: This connection uses OAuth2 for secure authentication.

​
How It Works

When you connect Calendly in NimbleBrain Studio:
  1. You’ll be redirected to Calendly’s authorization page
  2. Log in with your Calendly account
  3. Review and grant permissions
  4. You’re automatically redirected back to Studio

​
Required Scopes

The integration requests the following Calendly scopes: Event Scopes:
  • Read scheduled events
  • Cancel events
  • Create event types
User Scopes:
  • Read user profile
  • Access organization data
Webhook Scopes:
  • Create and manage webhooks
You can manage connected apps in your Calendly account under Integrations → Connected Apps.

​
Plan Requirements

Different features require different Calendly plan levels:
FeatureRequired Plan
Basic schedulingFree
Custom booking linksFree
Group eventsProfessional+
WebhooksProfessional+
Data deletion (GDPR)Enterprise
Round robin schedulingTeams+
Admin featuresTeams+
Some API features require paid Calendly plans. Check your plan’s capabilities before using advanced features.

​
Rate Limits

Calendly API enforces rate limits:
Limit TypeRestriction
API requests2,000 requests per 5 minutes
Webhook deliveriesVaries by plan
Concurrent connectionsBased on plan
Studio automatically handles rate limiting with exponential backoff for retries.

​
Troubleshooting

Issue: OAuth authorization didn’t completeSolutions:
  • Ensure you’re logged into the correct Calendly account
  • Try a different browser or incognito mode
  • Check popup blockers aren’t interfering
  • Verify your Calendly account is active
Issue: Insufficient privileges errorSolutions:
  • Reconnect to grant additional scopes
  • Verify your Calendly plan supports the feature
  • Check organization admin settings
  • For team features, ensure proper role assignment
Issue: Cannot find specified eventSolutions:
  • Verify the event UUID is correct
  • Event may have been cancelled or deleted
  • Check you have access to the event
  • Ensure event is within accessible date range
Issue: Webhook not receiving eventsSolutions:
  • Verify webhook URL is accessible
  • Check subscription is active
  • Ensure endpoint returns 2xx status
  • Verify event types are subscribed
Issue: Feature requires higher planSolutions:
  • Check Calendly plan requirements
  • Upgrade plan for advanced features
  • Enterprise features require Enterprise plan
  • Contact Calendly for plan changes
Issue: Too many requests errorSolutions:
  • Wait for rate limit to reset (5 minutes)
  • Reduce frequency of requests
  • Batch operations when possible
  • Studio automatically handles retries

​
Best Practices

Event Management

  • Use descriptive event type names
  • Set appropriate buffer times
  • Configure timezone properly
  • Use one-off events for unique meetings
  • Archive old event types

Booking Links

  • Use single-use links for VIPs
  • Set expiration dates when needed
  • Track link usage for analytics
  • Customize link settings per use case
  • Test links before sharing

No-Show Management

  • Track no-shows consistently
  • Follow up with no-show invitees
  • Analyze no-show patterns
  • Consider reminder integrations
  • Document cancellation reasons

Integrations

  • Use webhooks for real-time updates
  • Integrate with CRM for lead tracking
  • Connect to communication tools
  • Set up automated follow-ups
  • Monitor webhook health

Calendly API Reference

Official Calendly API documentation

Calendly Help Center

Calendly support and guides

Calendly Integrations

Browse native Calendly integrations
Need help? Join the NimbleBrain Discord or email [email protected]