Booking and scheduling inside your app.

// Who can be booked, when, and for what.
await coss.scheduling.hosts.create({
  uid: "tutor_482",
  name: "Ana Reyes",
  email: "ana@example.com",
  time_zone: "America/New_York",
});

await coss.scheduling.schedules.create("tutor_482", {
  rules: [{ days: [1, 2, 3, 4, 5], start: "09:00", end: "17:00" }],
});

const { data: eventType } = await coss.scheduling.eventTypes.create({
  title: "Trial lesson",
  duration_minutes: 30,
  buffer_after_minutes: 10,
  hosts: [{ host: "tutor_482" }],
  locations: [{ type: "google_meet" }],
});

// Emails from your own domain, and an SMS reminder from your approved number.
await coss.scheduling.settings.update({
  allowed_origins: ["https://app.example.com"],
  brand_name: "Acme Tutors",
  email_from: "bookings@example.com",
  sms_from: "+14155550123",
  notifications: { reminder: { email_attendee: true, sms_attendee: true } },
});

const { data: session } = await coss.scheduling.sessions.createForBooker({
  event_type: eventTypeId,
  attendee: { uid: "customer_77", name: "Sam Lee", email: "sam@example.com", time_zone: "UTC" },
});
// Hand session?.url to the browser.

mountBooker({
  url: sessionUrl,
  container,
  onEvent: (event) => {
    if (event.type === "booked") console.log("Booked", event.booking_id);
  },
});

const { data: slots } = await coss.scheduling.slots.list(eventTypeId, {
  start: "2027-01-04T00:00:00Z",
  end: "2027-01-11T00:00:00Z",
});

const { error } = await coss.scheduling.bookings.create({
  event_type: eventTypeId,
  start: slots!.data[0]!.start,
  attendee: {
    uid: "customer_77",
    name: "Sam Lee",
    email: "sam@example.com",
    phone: "+14155550199",
    time_zone: "America/Chicago",
  },
});
if (error?.code === "slot_unavailable") {
  // Someone else got there first: show the times again.
}