Calendeur
API key

API reference

Event types

An event type is a bookable meeting: its length, location (video, phone, in person) and scheduling rules. You need an event type ID to check availability and book.

List event types

GET/api/v1/event-types

All event types on the account, including hidden ones.

Scope: read:bookings

Query parameters

activeboolean

Pass true to return only bookable event types.

curl "https://calendeur.com/api/v1/event-types" \
  -H "Authorization: Bearer $CALENDEUR_API_KEY"
Response · 200
{
  "object": "list",
  "data": [
    {
      "id": "evt_30min",
      "object": "event_type",
      "title": "30-minute intro call",
      "slug": "intro",
      "description": "A short call to see if we're a fit.",
      "duration_minutes": 30,
      "location_type": "google_meet",
      "price": 0,
      "currency": "USD",
      "active": true,
      "hidden_from_profile": false,
      "scheduling": "one_on_one",
      "max_attendees": 1,
      "booking_url": "https://calendeur.com/jordan/intro"
    }
  ]
}

Get an event type

GET/api/v1/event-types/{id}

One event type by ID.

Scope: read:bookings

Path parameters

idstringrequired

The event type ID.

curl "https://calendeur.com/api/v1/event-types/ID" \
  -H "Authorization: Bearer $CALENDEUR_API_KEY"
Response · 200
{
  "id": "evt_30min",
  "object": "event_type",
  "title": "30-minute intro call",
  "duration_minutes": 30,
  "active": true
}
PreviousAccountNext Availability