Skip to main content
This guide walks you through obtaining all required credentials for the Cal.com (cal) plugin.

Authentication Method

The Cal plugin uses API key authentication.
  • api_key (default) — Cal.com API key for server-to-server access

API Key

Step 1: Create an API Key in Cal.com

  1. Log in to Cal.com.
  2. Open SettingsDeveloperAPI keys (wording may appear as Developer or API depending on your Cal.com version).
  3. Click to create a new API key.
  4. Give it a label (for example, Corsair) and confirm any scope or permission prompts.
  5. Copy the key when it is shown — you typically cannot view it again after creation.
Storing credentials:
pnpm corsair setup --plugin=cal api_key=your-cal-api-key
Verify:
pnpm corsair auth --plugin=cal --credentials

Webhooks (Optional)

If you use Cal.com webhooks, configure the signing or verification secret Cal provides for your webhook endpoint and store it as webhook_signature if your deployment verifies incoming requests with the value Corsair reads from the key store.
pnpm corsair setup --plugin=cal webhook_signature=your-webhook-secret

Required Credentials Summary

CredentialRequired forWhere to find
API keyapi_key authCal.com → Settings → Developer → API keys
Webhook secretWebhooks (if used)Cal.com webhook / app settings
For general information about how Corsair handles authentication, see Authentication.