Booking redirects

Find out how to manage the booking flow.

This is now deprecated and under maintenance for existing users only - no new customers can sign up for the platform plan

When creating an OAuth client you can specify:

1. booking URL to manage where people land after booking after one of your users.
2. reschedule URL to your page for rescheduling a booking.
3. cancel URL to your page for cancelling a booking.

This guide will explain each of the URLs and how to create page for each of them using atoms and our hooks.

Booking URL

After a person books one of your users, that person should see the successful booking.

Page in the booking URL will take URL parameter provided by us and then hook to fetch the booking and then display it. Here is an example:

1. Pass my-app.com/bookings as the redirectURI.
2. In your app, create my-app.com/bookings/[bookingUid] page where bookingUid will become path parameter.
3. When a booking occurs, booker will be re-directed to the redirectURI with booking UID as the bookingUid parameter aka my-app.com/bookings/[bookingUid].
4. In the my-app.com/bookings/[bookingUid] route create a page that imports useBooking hook, then extract bookingUid from URL parameter, and uses the hook to display booking information. Because useBooking hook can return individual booking or an array of recurring bookings, you need to handle single booking and array of bookings cases separately:

import { useBooking } from "@calcom/atoms";

export default function Bookings(props: { calUsername: string; calEmail: string }) {
    const router = useRouter();

    const { isLoading, data: booking, refetch } = useBooking((router.query.bookingUid as string) ?? "");

    return (
        <>
          {!Array.isArray(booking) ? (
              <p>{booking.title}</p>
          ) : (
              booking.map((recurrence) => <p key={recurrence.id}>{recurrence.title}</p>)
          )}
        </>
    )
};

An example implementation can be found here.

Reschedule URL

1. Pass my-app.com/bookings/reschedule as the redirectURI.
2. When “Reschedule” is clicked, user will be re-directed to the redirectURI with rescheduled and eventTypeSlug query parameters my-app.com/reschedule?rescheduleUid=buiaE8jHmNAxLrqitahCeL&eventTypeSlug=thirty-minutes
3. In the my-app.com/reschedule route create a page that extracts rescheduleUid and eventTypeSlug from the query parameters and passes the to the Booker atom:

const rescheduleUid = (router.query.rescheduleUid as string) ?? "";
const eventTypeSlugQueryParam = (router.query.eventTypeSlug as string) ?? "";

<Booker
    rescheduleUid={rescheduleUid}
    eventSlug={eventTypeSlugQueryParam}
    username={calUsername}
/>

You only need rescheduleUid, eventSlug and username.

An example implementation can be found here.

Cancel URL

1. Pass my-app.com/bookings/cancel as the cancelURI.
2. In your app, create my-app.com/bookings/cancel/[bookingUid] page where bookingUid will become path parameter.
3. In the page of my-app.com/cancel/[bookingUid] import useCancelBooking from atoms and get access to the cancel mutation import from “@calcom/atoms”;

const { mutate: cancelBooking } = useCancelBooking({
    onSuccess: () => {
      refetch();
    },
});

4. Create a cancel button that invokes mutation returned by the “useCancelBooking”. You have to pass id of the booking which you can get by fetching booking using “useBooking” hook by uid from the query params. Provide a suitable “cancellationReason”. Because useBooking hook can return individual booking or an array of recurring bookings, you need to handle single booking and array of bookings cases separately:

import { useBooking, useCancelBooking } from "@calcom/atoms";

...
const { isLoading, data: booking, refetch } = useBooking((router.query.bookingUid as string) ?? "");
const { mutate: cancelBooking } = useCancelBooking({
    onSuccess: () => {
      refetch();
    },
  });
...
   return !Array.isArray(booking) ? (
    <button
      className="underline"
      onClick={() => {
        cancelBooking({
          id: booking.id,
          cancellationReason: "User request",
        });
      }}
    >
      Cancel
    </button>
  ) : (
    <>
      {booking.map((recurrence) => (
        <button
          key={recurrence.id}
          className="underline"
          onClick={() => {
            cancelBooking({
              id: recurrence.id,
              cancellationReason: "User request",
            });
          }}
        >
          Cancel
        </button>
      ))}
    </>
  );

An example implementation can be found here.

---

Previous: User/Teams Hooks

Hooks for users and teams

Next: Booking Fields

Manage booking fields