Skip to main content

Calendly

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your Calendly account to Nirvai to manage scheduling, events, and bookings programmatically.

Supported Authentication Methods​

  • Personal Access Token - Recommended for personal/single-user integrations

Prerequisites​

  • A Calendly account (free or paid)
  • Account owner or admin permissions (for organization-wide access)

Setup Instructions​

Generating a Personal Access Token​

  1. Log in to your Calendly account
  2. Go to Integrations & apps in the sidebar
  3. Scroll down to API & Connectors section
  4. Click on API & Webhooks
  5. Under "Personal Access Tokens", click Create new token
  6. Enter a name for your token (e.g., "Nirvai Integration")
  7. Select the organization this token should access
  8. Click Create token
  9. Important: Copy the token immediately - it won't be shown again
  10. In Nirvai, create a new Calendly credential and paste the token

Alternative Path​

You can also access tokens directly at:

https://calendly.com/integrations/api_webhooks

Token Permissions​

Personal Access Tokens have these characteristics:

  • Access is scoped to your user and selected organization
  • Read and write access to scheduling data
  • Can create webhooks for event notifications
  • Tokens don't expire but can be revoked

Available API Operations​

With your token, you can:

  • Manage event types and availability
  • List and view scheduled events
  • Access user and organization data
  • Create webhooks for real-time notifications
  • Manage routing forms (on supported plans)

Troubleshooting​

Common Issues​

  • 401 Unauthorized: Token is invalid or was revoked. Generate a new token.
  • 403 Forbidden: Action not permitted for your account type or plan.
  • 404 Not Found: Resource doesn't exist or you don't have access.
  • Scope limitations: Some endpoints require specific Calendly plans.

Managing Tokens​

To view or revoke existing tokens:

  1. Go to Integrations & apps > API & Webhooks
  2. View all active tokens under "Personal Access Tokens"
  3. Click the delete icon to revoke a token

Plan Limitations​

Some API features require specific Calendly plans:

FeatureRequired Plan
Basic schedulingAll plans
Team eventsTeams or higher
Routing formsProfessional or higher
Round robinTeams or higher

Security Best Practices​

  • Use descriptive names for tokens to track their purpose
  • Revoke tokens you no longer need
  • Never share tokens or commit them to version control
  • Consider separate tokens for different integrations

Adapted for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.