How to Find Your Event Type ID

Every event type in Cal ID has a unique numeric Event Type ID. You need it whenever you call the API, wire up an advanced integration, or troubleshoot a specific booking workflow. You do not have to look it up in the API — it is visible in your browser’s address bar while you edit the event.

Find your Event Type ID

Open your dashboard at https://cal.id/home.

Go to Event Types

Click Event Types in the left-hand sidebar.

Edit the event

Find the event you want and click Edit.

Read the ID from the URL

Look at the URL in your browser’s address bar. The Event Type ID is the number in the path.

Browser address bar showing a cal.id/event-types URL with the numeric ID sitting before the tabName query parameter — Spotting the ID while you edit

Example — if the URL is https://cal.id/event-types/12345?tabName=Setup, your Event Type ID is 12345.

Use it in an API call

Pass the ID straight into the API path or a request body:

curl "https://api.cal.id/event-types/12345" \
  -H "Authorization: Bearer calid_xxxxx"

const eventTypeId = 12345;

async function getEventType() {
  const res = await fetch(`https://api.cal.id/event-types/${eventTypeId}`, {
    headers: { Authorization: `Bearer ${process.env.CALID_KEY}` },
  });

  const body = await res.json();
  if (!res.ok) throw new Error(body.message ?? `HTTP ${res.status}`);
  return body.data;
}

getEventType().then((eventType) => console.log(eventType.title));

import os
import requests

CALID_KEY = os.environ["CALID_KEY"]
event_type_id = 12345

response = requests.get(
    f"https://api.cal.id/event-types/{event_type_id}",
    headers={"Authorization": f"Bearer {CALID_KEY}"},
)
response.raise_for_status()

print(response.json()["data"]["title"])

Need every ID at once? Call GET /event-types/ — but remember it returns only 10 results by default, so pass an explicit limit such as ?limit=100. See API integration for the full list of conventions.

When you need this ID

API integrations — target a specific event type when creating bookings or reading slots.
Webhooks — identify which event type fired a notification from the eventTypeId field in the payload.
Custom styles — apply CSS or scripts to one particular booking page.
Support — our team may ask for the ID to investigate an issue with a specific event.

If you juggle several IDs on a team project, keep a simple sheet mapping each event name to its Event Type ID. It saves clicking into every event type each time you need one.

Where event type IDs are used

API integration

Base URL, authentication, response envelopes, and common pitfalls.

Get your API key

Create the bearer token every request needs.

Manage event types

Create, update, and delete event types through the API.

Webhooks

Subscribe to booking events and read the event type from the payload.

Get started

Guides

How to Find Your Event Type ID

Find your Event Type ID

Use it in an API call

When you need this ID

Where event type IDs are used

API integration

Get your API key

Manage event types

Webhooks

​Find your Event Type ID

​Use it in an API call

​When you need this ID

​Where event type IDs are used

API integration

Get your API key

Manage event types

Webhooks

Find your Event Type ID

Use it in an API call

When you need this ID

Where event type IDs are used