MCP is live.Set upAsk the community
OmniDimension
Dashboard
DocumentationAPI referenceSDKsMCP
Api referenceGeneratedIntegrations

Create a Cal.com integration

Connect a Cal.com event type so an agent can check availability and book meetings during a call. Attach it to an agent with `attachAgentIntegration`.

POST/integrations/cal
Body
5 fields
·

Reseller keys only: act as one of your clients by its user id. Omit it to act on your own account. [How acting for a client works](/docs/reseller/your-clients/acting-as-clients).

A name for the integration.

Your Cal.com API key.

The Cal.com event type id to book.

IANA time zone for the bookings, such as America/New_York.

curl -X POST 'https://omnidim.io/api/v1/integrations/cal' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "user_id": 1234
}'
Example response
synthetic
{
  "success": false,
  "message": "string",
  "integration_id": 0,
  "integration": {
    "id": 0,
    "name": "string",
    "integration_type": "google_sheets",
    "user_id": 0,
    "user_name": "string",
    "organization_id": 0,
    "organization_name": "string"
  }
}

Authorization

BearerAuth
headerAuthorizationBearer <token>

Bearer token authentication. Obtain your API key from the OmniDimension dashboard.

Request Body

application/json
user_id?ClientUserId

Reseller keys only: act as one of your clients by its user id. Omit it to act on your own account. How acting for a client works.

name*string

A name for the integration.

cal_api_key*string

Your Cal.com API key.

cal_id*string

The Cal.com event type id to book.

cal_timezone*string

IANA time zone for the bookings, such as America/New_York.

Response body

application/json

Response Body

The integration was created.

application/json
success?boolean
message?string
integration_id?integer

Use it as integration_id to attach the integration to an agent.

integration?

The new integration. Stored credentials read ********.