Appointments Management

Event Types

Get Event Type Detail

GET /appointments/event-types/{event_type_id}

Get the full detail for one bookable event type (title, slug, duration, locations, hosts, attached schedule, buffers, booking fields).

Path Parameters

Example

curl "https://be.graph8.com/api/v1/appointments/event-types/42" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "id": 42, "title": "Intro call", "slug": "intro-call", "length": 30 } }

Returns 404 when the ID is not in the caller’s org.

Create Event Type

POST /appointments/event-types → 201

Create a bookable event type.

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/event-types" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Intro call",
    "slug": "intro-call",
    "length": 30,
    "description": "A 30-minute introduction call.",
    "scheduling_type": "round_robin",
    "schedule_id": 7,
    "time_zone": "Europe/London",
    "hidden": false,
    "requires_confirmation": false,
    "minimum_booking_notice": 120,
    "before_event_buffer": 0,
    "after_event_buffer": 0,
    "locations": [{"type": "zoom"}],
    "event_color": "#7E2DF3"
  }'

Response

{ "data": { "id": 42, "title": "Intro call", "slug": "intro-call", "length": 30 } }

Update Event Type

PATCH /appointments/event-types/{event_type_id}

Partially update an event type. Only the fields you send are changed (exclude_unset semantics). Same fields as create, all optional.

Path Parameters

Example

curl -X PATCH "https://be.graph8.com/api/v1/appointments/event-types/42" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Updated Intro Call", "length": 45}'

Response

{ "data": { "id": 42, "title": "Updated Intro Call", "length": 45 } }

Returns 400 when the body is empty, 403 when the event type belongs to another user, 409 on slug collision.

Delete Event Type

DELETE /appointments/event-types/{event_type_id}

Delete an event type. Returns 403 when the caller is not the host/owner.

Path Parameters

Example

curl -X DELETE "https://be.graph8.com/api/v1/appointments/event-types/42" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "deleted": true, "event_type_id": 42 } }

Duplicate Event Type

POST /appointments/event-types/{event_type_id}/duplicate → 201

Duplicate an event type. Generates a unique {slug}-copy slug and copies all hosts verbatim.

Path Parameters

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/event-types/42/duplicate" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "id": 43, "title": "Intro call", "slug": "intro-call-copy", "length": 30 } }

Bookings

List Bookings

GET /appointments/bookings

List bookings visible to the caller (their own plus event types they host). is_admin is always false.

Query Parameters

Example

curl "https://be.graph8.com/api/v1/appointments/bookings?status=accepted&take=20" \
  -H "Authorization: Bearer $API_KEY"

Response

{
  "data": [
    {
      "id": 1,
      "uid": "uuid",
      "title": "Intro call with Jane Doe",
      "start_time": "2026-09-01T09:00:00Z",
      "end_time": "2026-09-01T09:30:00Z",
      "status": "accepted",
      "location": "zoom",
      "event_type": { "id": 42, "title": "Intro call", "slug": "intro-call", "length": 30 },
      "attendees": [{ "id": 1, "email": "[email protected]", "name": "Jane Doe", "no_show": false }],
      "sequence_id": null,
      "sequence_name": null,
      "from_reschedule": null,
      "created_at": "2026-08-15T12:00:00Z"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 1, "has_next": false }
}

Get Booking Detail

GET /appointments/bookings/{booking_uid}

Full booking detail including description, responses, meeting_url, references, internal_notes, recurring_event_id, cancellation_reason, rejection_reason, no_show_host, and rating.

Path Parameters

Example

curl "https://be.graph8.com/api/v1/appointments/bookings/some-booking-uuid" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "id": 1, "uid": "some-booking-uuid", "title": "Intro call", "status": "accepted", "meeting_url": "https://zoom.us/j/...", "description": null, "internal_notes": [] } }

Create Booking

POST /appointments/bookings → 201

Book an appointment. Charges ~20 credits. Requires an active subscription (402 if lapsed). Returns 409 on slot conflict.

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/bookings" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "event_type_id": 42,
    "start_time": "2026-09-01T09:00:00Z",
    "attendees": [
      { "name": "Jane Doe", "email": "[email protected]", "time_zone": "America/New_York" }
    ],
    "location": "zoom",
    "guests": ["[email protected]"]
  }'

Response

{ "data": { "id": 1, "uid": "new-booking-uuid", "status": "accepted", "meeting_url": "https://zoom.us/j/..." } }

Cancel Booking

POST /appointments/bookings/{booking_uid}/cancel

Cancel a booking. The request body is optional.

Path Parameters

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/bookings/some-booking-uuid/cancel" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cancellation_reason": "Scheduling conflict", "cancel_subsequent": false}'

Response

{ "data": { "id": 1, "uid": "some-booking-uuid", "status": "cancelled" } }

Reschedule Booking

POST /appointments/bookings/{booking_uid}/reschedule → 201

Reschedule a booking to a new time. Free — no credit charge.

Path Parameters

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/bookings/some-booking-uuid/reschedule" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_time": "2026-09-02T10:00:00Z", "rescheduling_reason": "Earlier slot available"}'

Response

Returns a new booking row representing the rescheduled appointment.

{ "data": { "id": 2, "uid": "new-rescheduled-uuid", "status": "accepted", "start_time": "2026-09-02T10:00:00Z" } }

Booking Insights

GET /appointments/bookings/insights

Aggregated booking insights (counts, show/no-show rates, per-event-type breakdown) for the caller’s org.

Query Parameters

Example

curl "https://be.graph8.com/api/v1/appointments/bookings/insights?date_from=2026-01-01&date_to=2026-12-31" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "total_bookings": 120, "accepted": 98, "cancelled": 15, "no_show_rate": 0.07 } }

Confirm or Reject Booking

POST /appointments/bookings/{booking_uid}/confirm

Confirm or reject a booking that requires host approval (requires_confirmation=true on the event type).

Path Parameters

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/bookings/some-booking-uuid/confirm" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"confirmed": true}'

Response

{ "data": { "id": 1, "uid": "some-booking-uuid", "status": "accepted" } }

Mark Booking Absent

POST /appointments/bookings/{booking_uid}/mark-absent

Mark the host and/or specific attendees as no-show.

Path Parameters

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/bookings/some-booking-uuid/mark-absent" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"host": false, "attendees": [{"email": "[email protected]"}]}'

Response

{ "data": { "id": 1, "uid": "some-booking-uuid", "no_show_host": false } }

Change Booking Location

PATCH /appointments/bookings/{booking_uid}/location

Change the meeting location for a booked appointment and re-notify both parties.

Path Parameters

Request Body

Example

curl -X PATCH "https://be.graph8.com/api/v1/appointments/bookings/some-booking-uuid/location" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "google_meet"}'

Response

{ "data": { "id": 1, "uid": "some-booking-uuid", "location": "google_meet" } }

Request Reschedule from Attendee

POST /appointments/bookings/{booking_uid}/request-reschedule

Send a reschedule-request email to the attendee (host-side action). Does not move or cancel the original booking; the attendee reschedules via the link in the email.

Path Parameters

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/bookings/some-booking-uuid/request-reschedule" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Something came up on my end."}'

Response

{ "data": { "id": 1, "uid": "some-booking-uuid", "status": "accepted" } }

Add Guests to Booking

POST /appointments/bookings/{booking_uid}/guests

Invite additional guests (email addresses) to an existing booking. Sends notification emails.

Path Parameters

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/bookings/some-booking-uuid/guests" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"guests": ["[email protected]", "[email protected]"]}'

Response

{ "data": { "id": 1, "uid": "some-booking-uuid", "status": "accepted" } }

Add Internal Note to Booking

POST /appointments/bookings/{booking_uid}/notes → 201

Append an internal (host-only) note to a booking. Not visible to attendees.

Path Parameters

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/bookings/some-booking-uuid/notes" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Spoke about Q3 budget."}'

Response

{
  "data": {
    "id": 1,
    "text": "Spoke about Q3 budget.",
    "created_by_id": 7,
    "created_by_name": "Jane",
    "created_at": "2026-09-01T09:35:00Z"
  }
}

Associate Booking with Sequence

PATCH /appointments/bookings/{booking_uid}/sequence

Associate a booking with a sequencer sequence, or remove the link by passing null.

Path Parameters

Request Body

Example

curl -X PATCH "https://be.graph8.com/api/v1/appointments/bookings/some-booking-uuid/sequence" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sequence_id": "seq-uuid"}'

Response

{ "data": { "id": 1, "uid": "some-booking-uuid", "sequence_id": "seq-uuid" } }

Schedules & Availability

List Schedules

GET /appointments/schedules

List the caller’s availability schedules. Each item includes id, name, time_zone, is_default, availability, overrides, created_at, owner_name, and owner_email.

Example

curl "https://be.graph8.com/api/v1/appointments/schedules" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": [{ "id": 7, "name": "Business Hours", "time_zone": "America/New_York", "is_default": true }] }

Get Schedule Detail

GET /appointments/schedules/{schedule_id}

Full schedule detail including linked_event_types — the list of event types currently using this schedule.

Path Parameters

Example

curl "https://be.graph8.com/api/v1/appointments/schedules/7" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "id": 7, "name": "Business Hours", "time_zone": "America/New_York", "is_default": true, "linked_event_types": [{ "id": 42, "title": "Intro call" }] } }

Create Schedule

POST /appointments/schedules → 201

Create a named availability schedule. days is an array of weekday integers: 0 = Sunday, 1 = Monday, … 6 = Saturday.

Request Body

Each availability item: { "days": [1,2,3,4,5], "start_time": "09:00", "end_time": "17:00" }.

Each overrides item: { "date": "2026-12-25", "start_time": "00:00", "end_time": "00:00" }.

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/schedules" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Business Hours",
    "time_zone": "America/New_York",
    "is_default": false,
    "availability": [
      { "days": [1, 2, 3, 4, 5], "start_time": "09:00", "end_time": "17:00" }
    ],
    "overrides": [
      { "date": "2026-12-25", "start_time": "00:00", "end_time": "00:00" }
    ]
  }'

Response

{ "data": { "id": 7, "name": "Business Hours", "time_zone": "America/New_York", "is_default": false } }

Update Schedule

PATCH /appointments/schedules/{schedule_id}

Partially update a schedule. When availability is provided it replaces all weekly recurring rules. When overrides is provided it replaces all date-specific overrides. Omit a key to leave that set unchanged.

Path Parameters

Request Body

All fields optional.

Example

curl -X PATCH "https://be.graph8.com/api/v1/appointments/schedules/7" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Extended Hours", "availability": [{"days": [1,2,3,4,5], "start_time": "08:00", "end_time": "18:00"}]}'

Response

{ "data": { "id": 7, "name": "Extended Hours", "time_zone": "America/New_York" } }

Delete Schedule

DELETE /appointments/schedules/{schedule_id}

Delete a schedule. Returns 409 when this is the caller’s last schedule (every user must keep at least one). Returns 404 when the schedule does not exist or belongs to another user.

Path Parameters

Example

curl -X DELETE "https://be.graph8.com/api/v1/appointments/schedules/7" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "deleted": true, "schedule_id": 7 } }

Get Schedule Availability

GET /appointments/schedules/{schedule_id}/availability

Return the weekly recurring rules and date-specific overrides for a schedule.

Path Parameters

Example

curl "https://be.graph8.com/api/v1/appointments/schedules/7/availability" \
  -H "Authorization: Bearer $API_KEY"

Response

{
  "data": {
    "schedule_id": 7,
    "availability": [
      { "id": 1, "days": [1, 2, 3, 4, 5], "start_time": "09:00", "end_time": "17:00", "date": null }
    ],
    "overrides": [
      { "id": 2, "days": null, "start_time": "00:00", "end_time": "00:00", "date": "2026-12-25" }
    ]
  }
}

Update Schedule Availability

PATCH /appointments/schedules/{schedule_id}/availability

Replace weekly rules and/or date overrides. At least one of availability or overrides is required (returns 400 otherwise). Omit a key to leave that set unchanged.

Path Parameters

Request Body

Example

curl -X PATCH "https://be.graph8.com/api/v1/appointments/schedules/7/availability" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "availability": [{ "days": [1,2,3,4,5], "start_time": "08:00", "end_time": "18:00" }],
    "overrides": []
  }'

Response

{
  "data": {
    "schedule_id": 7,
    "availability": [{ "id": 1, "days": [1,2,3,4,5], "start_time": "08:00", "end_time": "18:00", "date": null }],
    "overrides": []
  }
}

Set Default Schedule

POST /appointments/schedules/{schedule_id}/set-default

Mark a schedule as the caller’s default. Used when an event type has no schedule attached. Returns 404 when the schedule does not exist or belongs to another user.

Path Parameters

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/schedules/7/set-default" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "id": 7, "name": "Business Hours", "is_default": true } }

Out of Office

List Out-of-Office Entries

GET /appointments/out-of-office

List the caller’s out-of-office entries. API keys always see only their own.

Example

curl "https://be.graph8.com/api/v1/appointments/out-of-office" \
  -H "Authorization: Bearer $API_KEY"

Response

{
  "data": [
    {
      "id": 1,
      "uuid": "ooo-entry-uuid",
      "start": "2026-08-01T00:00:00Z",
      "end": "2026-08-15T00:00:00Z",
      "notes": "Summer holiday",
      "to_user_id": null,
      "reason": "vacation",
      "created_at": "2026-07-01T10:00:00Z"
    }
  ]
}

Create Out-of-Office Entry

POST /appointments/out-of-office → 201

Create an out-of-office entry. While active, the caller’s slots are blocked for booking.

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/out-of-office" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "start": "2026-08-01T00:00:00Z",
    "end": "2026-08-15T00:00:00Z",
    "notes": "Summer holiday",
    "to_user_id": 12,
    "reason": "vacation"
  }'

Response

{
  "data": {
    "id": 1,
    "uuid": "ooo-entry-uuid",
    "start": "2026-08-01T00:00:00Z",
    "end": "2026-08-15T00:00:00Z",
    "notes": "Summer holiday",
    "to_user_id": 12,
    "reason": "vacation",
    "created_at": "2026-07-01T10:00:00Z"
  }
}

Delete Out-of-Office Entry

DELETE /appointments/out-of-office/{ooo_uuid}

Delete an out-of-office entry. Only the owner can delete their own entry.

Path Parameters

Example

curl -X DELETE "https://be.graph8.com/api/v1/appointments/out-of-office/ooo-entry-uuid" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "deleted": true, "ooo_uuid": "ooo-entry-uuid" } }

Routing Forms

List Routing Forms

GET /appointments/routing-forms

List routing forms owned by the calling user. Each item includes response_count (total submissions).

Example

curl "https://be.graph8.com/api/v1/appointments/routing-forms" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": [{ "id": 3, "name": "Sales Triage", "response_count": 42 }], "pagination": { "total": 3 } }

Get Routing Form Detail

GET /appointments/routing-forms/{form_id}

Full routing form detail including fields, routes, and response_count. Returns 404 when not found or owned by another user.

Path Parameters

Example

curl "https://be.graph8.com/api/v1/appointments/routing-forms/3" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "id": 3, "name": "Sales Triage", "fields": [], "routes": [], "response_count": 42 } }

Create Routing Form

POST /appointments/routing-forms → 201

Create a routing form with optional fields and conditional routes.

Request Body

Each fields item:

Each routes item:

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/routing-forms" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales Triage",
    "description": "Route inbound leads to the right event type.",
    "fields": [
      {
        "label": "Company size",
        "type": "select",
        "required": true,
        "identifier": "company_size",
        "options": [{ "label": "1-50", "value": "sm" }]
      }
    ],
    "routes": [
      {
        "conditions": [{ "field": "company_size", "operator": "eq", "value": "sm" }],
        "action_type": "redirect_event_type",
        "action_value": "42",
        "is_fallback": false,
        "position": 0
      }
    ]
  }'

Response

{ "data": { "id": 3, "name": "Sales Triage", "fields": [], "routes": [], "response_count": 0 } }

Update Routing Form

PATCH /appointments/routing-forms/{form_id}

Partially update a routing form. fields and routes are replaced wholesale when present. slug must be unique in the org (409 on collision).

Path Parameters

Request Body

All fields optional.

Example

curl -X PATCH "https://be.graph8.com/api/v1/appointments/routing-forms/3" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Updated Sales Triage", "disabled": false}'

Response

{ "data": { "id": 3, "name": "Updated Sales Triage", "disabled": false } }

Delete Routing Form

DELETE /appointments/routing-forms/{form_id}

Delete a routing form permanently. Cascades to its fields and routes.

Path Parameters

Example

curl -X DELETE "https://be.graph8.com/api/v1/appointments/routing-forms/3" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "deleted": true, "form_id": 3 } }

Duplicate Routing Form

POST /appointments/routing-forms/{form_id}/duplicate → 201

Duplicate a routing form with all fields and routes. The copy is named "{name} (copy)" with a unique auto-generated slug.

Path Parameters

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/routing-forms/3/duplicate" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "id": 4, "name": "Sales Triage (copy)", "fields": [], "routes": [], "response_count": 0 } }

List Routing Form Responses

GET /appointments/routing-forms/{form_id}/responses

List captured form responses. Paginated via skip / take.

Path Parameters

Query Parameters

Example

curl "https://be.graph8.com/api/v1/appointments/routing-forms/3/responses?skip=0&take=50" \
  -H "Authorization: Bearer $API_KEY"

Response

{
  "data": {
    "responses": [
      {
        "id": 1,
        "form_id": 3,
        "responses": { "company_size": "sm" },
        "routed_to_event_type_id": 42,
        "created_at": "2026-09-01T10:00:00Z"
      }
    ],
    "total_count": 1
  },
  "pagination": { "skip": 0, "take": 50, "total": 1, "has_next": false }
}

Workflows

Appointment workflows fire automated notifications (email / SMS reminders) at configurable trigger points in the booking lifecycle.

List Workflows

GET /appointments/workflows

List all workflows for the org.

Example

curl "https://be.graph8.com/api/v1/appointments/workflows" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": [{ "id": 5, "name": "24h Reminder", "trigger": "before_event", "time": 1440, "is_active_on_all": true }] }

Get Workflow Detail

GET /appointments/workflows/{workflow_id}

Full workflow detail including steps and linked event types.

Path Parameters

Example

curl "https://be.graph8.com/api/v1/appointments/workflows/5" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "id": 5, "name": "24h Reminder", "trigger": "before_event", "time": 1440, "steps": [], "linked_event_types": [] } }

Create Workflow

POST /appointments/workflows → 201

Create a workflow.

Request Body

Each steps item:

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/workflows" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "24h Reminder",
    "trigger": "before_event",
    "time": 1440,
    "time_unit": "minutes",
    "is_active_on_all": true,
    "steps": [
      {
        "action": "EMAIL_ATTENDEE",
        "template": "REMINDER",
        "email_subject": "Reminder: Your meeting is tomorrow",
        "reminder_body": "See you soon.",
        "include_calendar_event": false
      }
    ]
  }'

Response

{ "data": { "id": 5, "name": "24h Reminder", "trigger": "before_event", "time": 1440, "is_active_on_all": true } }

Update Workflow

PATCH /appointments/workflows/{workflow_id}

Partially update a workflow. Only owned workflows may be updated (403 otherwise). When provided, steps replaces all steps and event_type_ids replaces all linked event-type attachments.

Path Parameters

Request Body

All fields optional.

Example

curl -X PATCH "https://be.graph8.com/api/v1/appointments/workflows/5" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "48h Reminder", "time": 2880}'

Response

{ "data": { "id": 5, "name": "48h Reminder", "trigger": "before_event", "time": 2880 } }

Delete Workflow

DELETE /appointments/workflows/{workflow_id} → 204

Delete a workflow and cancel any pending reminder rows. Only owned workflows may be deleted.

Path Parameters

Example

curl -X DELETE "https://be.graph8.com/api/v1/appointments/workflows/5" \
  -H "Authorization: Bearer $API_KEY"

No response body (204 No Content).

Toggle Workflow

POST /appointments/workflows/{workflow_id}/toggle

Activate or deactivate a workflow. Only owned workflows may be toggled. Deactivating cancels all pending reminder rows.

Path Parameters

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/workflows/5/toggle" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"active": false}'

Response

{ "data": { "id": 5, "name": "24h Reminder", "active": false } }

Integrations (Calendars & Conferencing)

List Calendar Accounts

GET /appointments/calendars

List calendar accounts (Google Calendar, Outlook) connected to the caller’s appointments profile, each with sub-calendars and their selection state.

Example

curl "https://be.graph8.com/api/v1/appointments/calendars" \
  -H "Authorization: Bearer $API_KEY"

Response

[
  {
    "credential_id": 1,
    "provider": "google_calendar",
    "email": "[email protected]",
    "is_valid": true,
    "sub_calendars": [
      {
        "external_id": "[email protected]",
        "name": "Jane's Calendar",
        "is_selected": true,
        "is_primary": true,
        "read_only": false
      }
    ]
  }
]

Add Calendar to Conflict-Checking

POST /appointments/calendars/selected → 201

Add a sub-calendar to the caller’s conflict-checking set.

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/calendars/selected" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "credential_id": 1,
    "integration": "google_calendar",
    "external_id": "[email protected]"
  }'

Response

{ "data": { "id": "...", "integration": "google_calendar", "external_id": "[email protected]", "credential_id": 1 } }

Remove Calendar from Conflict-Checking

DELETE /appointments/calendars/selected

Remove a sub-calendar from conflict checking. Returns 204, no body.

Query Parameters

Example

curl -X DELETE "https://be.graph8.com/api/v1/appointments/calendars/selected?credential_id=1&integration=google_calendar&[email protected]" \
  -H "Authorization: Bearer $API_KEY"

Returns 204 No Content.

Disconnect Calendar Account

DELETE /appointments/calendars/{credential_id}

Disconnect a calendar account (best-effort token revocation plus credential row deletion). Returns 404 when not found; 403 when it belongs to another user.

Path Parameters

Example

curl -X DELETE "https://be.graph8.com/api/v1/appointments/calendars/1" \
  -H "Authorization: Bearer $API_KEY"

Returns 204 No Content.

Get Destination Calendar

GET /appointments/calendars/destination

Get the destination calendar where booking events are pushed. Returns {"data": null} when none is configured.

Query Parameters

Example

curl "https://be.graph8.com/api/v1/appointments/calendars/destination" \
  -H "Authorization: Bearer $API_KEY"

Response

{
  "data": {
    "id": 5,
    "integration": "google_calendar",
    "external_id": "[email protected]",
    "credential_id": 1,
    "event_type_id": null,
    "primary_email": "[email protected]"
  }
}

Set Destination Calendar

PUT /appointments/calendars/destination

Set (upsert) the destination calendar where booking events are pushed. Optionally scope to a specific event type.

Request Body

Example

curl -X PUT "https://be.graph8.com/api/v1/appointments/calendars/destination" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "integration": "google_calendar",
    "external_id": "[email protected]",
    "credential_id": 1,
    "event_type_id": null
  }'

Response

{ "data": { "id": 5, "integration": "google_calendar", "external_id": "[email protected]", "credential_id": 1 } }

List Conferencing Providers

GET /appointments/conferencing

List conferencing providers connected to the caller’s profile (Zoom, Google Meet, Microsoft Teams, Roam, Whereby, Jitsi). Google Meet is synthesized from an existing Google Calendar credential.

Example

curl "https://be.graph8.com/api/v1/appointments/conferencing" \
  -H "Authorization: Bearer $API_KEY"

Response

[{ "provider": "google_meet", "name": "Google Meet", "is_default": true, "credential_id": null, "link": null }]

Connect Conferencing Provider

POST /appointments/conferencing/connect/{provider} → 201

Connect a no-OAuth / link-based conferencing provider. Supported values for {provider}: google_meet, roam, roam_auto, whereby, jitsi. Zoom and office365_video (Teams) are excluded — they require a browser OAuth flow.

• google_meet: clears the google_meet_suppressed flag; requires an existing google_calendar credential.
• roam / whereby / jitsi: creates a credential row; optional link is the meeting URL.
• roam_auto: creates a stub credential row (no OAuth tokens).

Path Parameters

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/conferencing/connect/google_meet" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "provider": "google_meet", "status": "connected" } }

Disconnect Conferencing Provider

DELETE /appointments/conferencing/{provider}/disconnect

Disconnect a conferencing provider. For google_meet, sets google_meet_suppressed and clears the default if it pointed at Meet.

Path Parameters

Example

curl -X DELETE "https://be.graph8.com/api/v1/appointments/conferencing/google_meet/disconnect" \
  -H "Authorization: Bearer $API_KEY"

Returns 204 No Content.

Update Conferencing Provider Link

PUT /appointments/conferencing/{provider}/link

Set or update the meeting URL for a link-based provider (roam, whereby, jitsi). The provider must already be installed. The URL is validated against the provider’s expected URL pattern.

Path Parameters

Request Body

Example

curl -X PUT "https://be.graph8.com/api/v1/appointments/conferencing/roam/link" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"link": "https://meet.example.com/room"}'

Response

{ "data": { "provider": "roam", "link": "https://meet.example.com/room" } }

Get Default Conferencing Provider

GET /appointments/conferencing/default

Get the current default conferencing provider. Returns {"data": {"provider": null}} when none is configured.

Example

curl "https://be.graph8.com/api/v1/appointments/conferencing/default" \
  -H "Authorization: Bearer $API_KEY"

Response

{ "data": { "provider": "google_meet", "credential_id": null, "link": null } }

Set Default Conferencing Provider

POST /appointments/conferencing/{provider}/default

Set the default conferencing provider for new meetings. For link-based providers (roam, whereby, jitsi) a meeting URL is required — either in the request body or stored from a prior PUT /appointments/conferencing/{provider}/link.

Path Parameters

Request Body

Example

curl -X POST "https://be.graph8.com/api/v1/appointments/conferencing/zoom/default" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"credential_id": 5}'

Response

{ "data": { "provider": "zoom", "credential_id": 5, "link": null } }