---
title: "Book a meeting"
method: POST
path: "/scheduler/2026-03/meetings/meeting-links/book"
tags: ["Advanced"]
---

# Book a meeting

`POST /scheduler/2026-03/meetings/meeting-links/book`

Book a meeting for a specified meeting page.

## Request body

- SchedulerMeetingsExternalMeetingBooking
  - `duration` integer, required — The duration of the meeting in milliseconds.
  - `email` string, required — The email address of the person booking the meeting.
  - `firstName` string, required — The first name of the person booking the meeting.
  - `formFields` SchedulerMeetingsExternalBookingFormField[], required
    - `name` string, required — The name of the form field.
    - `value` string, required — The value associated with the form field.
  - `lastName` string, required — The last name of the person booking the meeting.
  - `legalConsentResponses` SchedulerMeetingsExternalLegalConsentResponse[], required
    - `communicationTypeId` string, required — The ID of communication consent form being recorded.
    - `consented` boolean, required — Whether the user has given consent for the specified communication type.
  - `likelyAvailableUserIds` string[], required
  - `locale` string — The locale used for formatting dates and times in the meeting booking.
  - `slug` string, required — The unique path identifier for the meeting page.
  - `startTime` string, date-time, required — The date and time when the meeting is scheduled to start, in ISO 8601 format.
  - `timezone` string — The timezone in which the meeting is scheduled.

## Response `200`

successful operation

- SchedulerMeetingsExternalMeetingBookingResponse
  - `bookingTimezone` string, required — The timezone the meeting was booked from.
  - `calendarEventId` string, required — The unique identifier for the meeting's calendar event.
  - `contactId` string, required — The ID of the contact associated to the meeting.
  - `duration` integer, required — The duration of the meeting in milliseconds.
  - `end` string, date-time, required — The date and time when the meeting is scheduled to end, in ISO 8601 format.
  - `formFields` SchedulerMeetingsExternalValidatedFormField[], required
    - `fieldType` string — The specific input type of the form field. Corresponds to property types (e.g., `select`, `radio`, `date`, etc).
    - `isCustom` boolean, required — Whether the form field is a custom field.
    - `label` string, required — The text label associated with the form field.
    - `name` string, required — The name identifier for the form field, includes underscores in place of spaces (e.g., the label `my form` is converted to `my_form`).
    - `translatedLabel` string — The translated text label for the form field.
    - `value` string, required — The value associated with the form field.
    - `valueLabel` string — The text label associated to a form field selection or option.
  - `guestEmails` string[], required
  - `isOffline` boolean, required — Whether the meeting was booked offline and no associated calendar event was created.
  - `legalConsentResponses` SchedulerMeetingsExternalLegalConsentResponse[], required
    - `communicationTypeId` string, required — The ID of communication consent form being recorded.
    - `consented` boolean, required — Whether the user has given consent for the specified communication type.
  - `locale` string — The locale the meeting was booked with, used to determine date formatting in calendar event description.
  - `location` string — The physical or virtual location where the meeting will take place.
  - `start` string, date-time, required — The date and time when the meeting is scheduled to start, in ISO 8601 format.
  - `subject` string, required — The title of the meeting and calendar event.
  - `webConferenceMeetingId` string — The unique identifier for the web conference meeting.
  - `webConferenceUrl` string — The URL for accessing the meeting's web conference.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/f9c7181056c5/schema)