Create a private booking link

Create a private booking link

Returns a private booking URL for an event type that expires after a number of bookings or at a set time.

Without expiresAt or maxUsageCount the link is single-use, so create one per prospect and send the returned bookingUrl. Set maxUsageCount to allow more bookings, or expiresAt to make the link time-based. Send cal-api-version: 2024-09-04. The MCP server has no dedicated tool for this call.

Set up

Use the first option your agent supports.

CLI (official)

Install the command, then confirm it runs.

npm install -g @calcom/cli
calcom --version

Run calcom private-links create.

Set $CAL_API_KEY in your environment first (get a key: https://app.cal.com/settings/developer/api-keys).

API (official)

• Base URL: https://api.cal.com
• Endpoint: POST /v2/event-types/{eventTypeId}/private-links
• Auth: send the header Authorization: Bearer $CAL_API_KEY
• Get a key: https://app.cal.com/settings/developer/api-keys
• Docs: https://cal.com/docs/api-reference/v2/introduction

Before doing anything else, make one read-only call to confirm access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data.
• Never print API keys.