Assign Cal.com Account to Agent

curl --request PUT \
  --url https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "calcom_account_id": "<string>"
}
'

import requests

url = "https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account"

payload = { "calcom_account_id": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({calcom_account_id: '<string>'})
};

fetch('https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'calcom_account_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account"

	payload := strings.NewReader("{\n  \"calcom_account_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"calcom_account_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"calcom_account_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": <boolean>,
  "message": "Agent Cal.com account updated",
  "data": {
    "agent_id": "<string>",
    "agent_name": "<string>",
    "calcom_account_id": "<string>"
  }
}

PUT

api

calcom

agents

{agent_id}

account

Assign Cal.com Account to Agent

curl --request PUT \
  --url https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "calcom_account_id": "<string>"
}
'

import requests

url = "https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account"

payload = { "calcom_account_id": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({calcom_account_id: '<string>'})
};

fetch('https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'calcom_account_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account"

	payload := strings.NewReader("{\n  \"calcom_account_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"calcom_account_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.ravan.ai/api/v1/calcom/agents/{agent_id}/account")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"calcom_account_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": <boolean>,
  "message": "Agent Cal.com account updated",
  "data": {
    "agent_id": "<string>",
    "agent_name": "<string>",
    "calcom_account_id": "<string>"
  }
}

Authorizations

string

required

Your JWT access token. Pass it as a Bearer token in the Authorization header. Example: Authorization: Bearer <token>.

Path Parameters

string

required

The agent UUID to link or unlink from an org-level Cal.com account.

Query Parameters

string

Optional fallback organization ID. It is used only when the JWT claims do not already include the org context.

Body

string

The org-level Cal.com account ID to link to the agent. Send null to unlink the current account from the agent.

Response

boolean

Whether the request succeeded.

string

Human-readable status message.

object

Updated agent Cal.com account assignment.

Show data

string

Agent UUID.

string

Agent display name.

string

Linked Cal.com account UUID, or null when unlinked.

{
  "success": <boolean>,
  "message": "Agent Cal.com account updated",
  "data": {
    "agent_id": "<string>",
    "agent_name": "<string>",
    "calcom_account_id": "<string>"
  }
}

{
  "success": false,
  "message": "<string>",
  "code": "INVALID_REQUEST"
}

{
  "success": false,
  "message": "<string>"
}

{
  "success": false,
  "message": "<string>",
  "code": "NOT_FOUND"
}

{
  "success": false,
  "message": "<string>",
  "code": "CONFLICT"
}

{
  "success": false,
  "message": "<string>",
  "code": "INTERNAL_ERROR"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id

string

required

Agent UUID

Query Parameters

org_id

string

Fallback organization ID used only when not present in JWT claims

Body

application/json

calcom_account_id

string | null

Org-level Cal.com account UUID, or null to unlink

Response

Agent Cal.com account updated

success

boolean

message

string

data

object

Show child attributes

Example:

{
  "agent_id": "<string>",
  "agent_name": "<string>",
  "calcom_account_id": "<string>"
}

Introduction

Agent API

Organization API

Agent Tool API

Phone Number & Telephony API

Campaign API

Contact API

Calling API

Appointment API

GHL Integration API

Cal.com Integration API

RAG Knowledge Base API

Webhooks

Health API

Assign Cal.com Account to Agent

Authorizations

Path Parameters

Query Parameters

Body

Response

Authorizations

Path Parameters

Query Parameters

Body

Response

​Authorizations

​Path Parameters

​Query Parameters

​Body

​Response

Authorizations

Path Parameters

Query Parameters

Body

Response

Authorizations

Path Parameters

Query Parameters

Body

Response