POST
/
api
/
v1
/
calcom
/
connect
curl -X POST https://api.ravan.ai/api/v1/calcom/connect \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "org_id": "1268c1f0-19f3-47db-aefb-c16a7c3ace6e",
    "api_key": "cal_live_your_api_key_here",
    "account_name": "Main Calendar"
  }'

{
  "success": true,
  "message": "Cal.com connected successfully",
  "data": {
    "provider_id": "019d4a3b-6c7d-8e9f-0a1b-2c3d4e5f6a7b",
    "org_id": "1268c1f0-19f3-47db-aefb-c16a7c3ace6e",
    "account_name": "Main Calendar",
    "status": "active",
    "connected_at": "2026-03-20T14:30:00Z"
  }
}

​
Authorizations

​
X-Api-Key
string
required
Your Agni API key. Find it in your support@ravan.ai under Settings → API Keys.

​
Body

​
org_id
string
required
UUID of your organization.
​
api_key
string
required
Your Cal.com API key (e.g. cal_live_...). Generate this from your Cal.com dashboard under Settings → Developer → API Keys.
​
account_name
string
A friendly name for this Cal.com connection (e.g. "Main Calendar").

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object
Connection details including the provider ID.
curl -X POST https://api.ravan.ai/api/v1/calcom/connect \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "org_id": "1268c1f0-19f3-47db-aefb-c16a7c3ace6e",
    "api_key": "cal_live_your_api_key_here",
    "account_name": "Main Calendar"
  }'

{
  "success": true,
  "message": "Cal.com connected successfully",
  "data": {
    "provider_id": "019d4a3b-6c7d-8e9f-0a1b-2c3d4e5f6a7b",
    "org_id": "1268c1f0-19f3-47db-aefb-c16a7c3ace6e",
    "account_name": "Main Calendar",
    "status": "active",
    "connected_at": "2026-03-20T14:30:00Z"
  }
}

Authorizations

​
X-Api-Key
string
header
required

Body

application/json
​
org_id
string
required
​
api_key
string
required

Cal.com API key

​
account_name
string

Response

Successful response

​
success
boolean
​
message
string
​
data
object