Appointments

Appointments The Appointments API lets you book appointments for your contacts on your event types, then fetch, list, update, cancel, or delete them. It also answers the question that comes first in most booking flows — which times are actually free — and covers the calendar side: listing the Google Calendars you have connected and importing events that already live in them. When a Google Calendar connection is active, the matching calendar event is created and kept in sync automatically in the background. Restaurants using Zenchef, Formitable, OpenTable or TheFork for their own reservations system can also be verified and connected here, so the AI Agent books real tables instead of internal appointments — and appointment businesses running their schedule in Trafft can connect that the same way. All paths on this page are relative to the base URL https://api.relaytiv.com/v1 . Every request needs your API key — see Authentication for the full list of ways to send it. The examples below use the X-API-Key header, with one cURL example showing the ?apiKey= query form too. Events vs. appointments: An event type is a bookable slot definition (the kind of meeting, its length, its rooms). An appointment is one booked instance of an event type for a specific contact. You book an appointment by referencing the contact and the event type. The appointment object Every endpoint that returns an appointment uses the same shape: Field Description id Unique ID of the appointment. contact_id I