HUhubspot
Advanced

Book a meeting

Changed on

Book a meeting for a specified meeting page.

post/scheduler/2026-03/meetings/meeting-links/book

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book
  • Auth
    • HTTP bearer
    • or API key in query parameter hapikey
    • or none

Request body

durationinteger required

The duration of the meeting in milliseconds.

emailstring required

The email address of the person booking the meeting.

firstNamestring required

The first name of the person booking the meeting.

lastNamestring required

The last name of the person booking the meeting.

likelyAvailableUserIdsstring[] required
localestring

The locale used for formatting dates and times in the meeting booking.

slugstring required

The unique path identifier for the meeting page.

startTimestring date-time required

The date and time when the meeting is scheduled to start, in ISO 8601 format.

timezonestring

The timezone in which the meeting is scheduled.

Response

successful operation

bookingTimezonestring required

The timezone the meeting was booked from.

calendarEventIdstring required

The unique identifier for the meeting's calendar event.

contactIdstring required

The ID of the contact associated to the meeting.

durationinteger required

The duration of the meeting in milliseconds.

endstring date-time required

The date and time when the meeting is scheduled to end, in ISO 8601 format.

guestEmailsstring[] required
isOfflineboolean required

Whether the meeting was booked offline and no associated calendar event was created.

localestring

The locale the meeting was booked with, used to determine date formatting in calendar event description.

locationstring

The physical or virtual location where the meeting will take place.

startstring date-time required

The date and time when the meeting is scheduled to start, in ISO 8601 format.

subjectstring required

The title of the meeting and calendar event.

webConferenceMeetingIdstring

The unique identifier for the web conference meeting.

webConferenceUrlstring

The URL for accessing the meeting's web conference.

Changes

  • b0d8bc008db9Revision changes
    • info

      the security scope crm.objects.listings.write was added to the endpoint's security scheme private_apps

    • info

      the security scope crm.objects.deals.highly_sensitive.write was removed from the endpoint's security scheme private_apps

  • 3578967e48dfRevision changes
    • info

      the security scope crm.objects.listings.write was added to the endpoint's security scheme private_apps

    • info

      the security scope crm.objects.deals.highly_sensitive.write was removed from the endpoint's security scheme private_apps

Some revisions have not been checked yet.