Passer au contenu principal
POST
/
scheduler
/
v3
/
meetings
/
meeting-links
/
book
Réserver une réunion
curl --request POST \
  --url https://api.hubapi.com/scheduler/v3/meetings/meeting-links/book \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "duration": 123,
  "email": "<string>",
  "firstName": "<string>",
  "formFields": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "lastName": "<string>",
  "legalConsentResponses": [
    {
      "communicationTypeId": "<string>",
      "consented": true
    }
  ],
  "likelyAvailableUserIds": [
    "<string>"
  ],
  "slug": "<string>",
  "startTime": "2023-11-07T05:31:56Z",
  "locale": "<string>",
  "timezone": "<string>"
}
'
{
  "bookingTimezone": "<string>",
  "calendarEventId": "<string>",
  "contactId": "<string>",
  "duration": 123,
  "end": "2023-11-07T05:31:56Z",
  "formFields": [
    {
      "isCustom": true,
      "label": "<string>",
      "name": "<string>",
      "value": "<string>",
      "fieldType": "<string>",
      "translatedLabel": "<string>",
      "valueLabel": "<string>"
    }
  ],
  "guestEmails": [
    "<string>"
  ],
  "isOffline": true,
  "legalConsentResponses": [
    {
      "communicationTypeId": "<string>",
      "consented": true
    }
  ],
  "start": "2023-11-07T05:31:56Z",
  "subject": "<string>",
  "locale": "<string>",
  "location": "<string>",
  "webConferenceMeetingId": "<string>",
  "webConferenceUrl": "<string>"
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit

Autorisations

Authorization
string
header
requis

The access token received from the authorization server in the OAuth 2.0 flow.

Corps

application/json
duration
integer<int64>
requis

La durée de la réunion en millisecondes.

email
string
requis

L'adresse e-mail de la personne qui réserve la réunion.

firstName
string
requis

Le prénom de la personne qui réserve la réunion.

formFields
object[]
requis
lastName
string
requis

Le nom de famille de la personne qui réserve la réunion.

likelyAvailableUserIds
string[]
requis
slug
string
requis

L'identifiant de chemin unique pour la page de réunion.

startTime
string<date-time>
requis

La date et l'heure prévues pour le début de la réunion, au format ISO 8601.

locale
string

Les paramètres régionaux utilisés pour le formatage des dates et des heures dans la réservation de réunion.

timezone
string

Le fuseau horaire dans lequel la réunion est prévue.

Réponse

successful operation

bookingTimezone
string
requis

Le fuseau horaire à partir duquel la réunion a été réservée.

calendarEventId
string
requis

L'identifiant unique de l'événement du calendrier de la réunion.

contactId
string
requis

L'ID du contact associé à la réunion.

duration
integer<int64>
requis

La durée de la réunion en millisecondes.

end
string<date-time>
requis

La date et l'heure prévues pour la fin de la réunion, au format ISO 8601.

formFields
object[]
requis
guestEmails
string[]
requis
isOffline
boolean
requis

Si la réunion a été réservée hors ligne et si aucun événement associé n'a été créé dans le calendrier.

start
string<date-time>
requis

La date et l'heure prévues pour le début de la réunion, au format ISO 8601.

subject
string
requis

Le titre de la réunion et de l'événement du calendrier.

locale
string

Le paramètre régional utilisé pour réserver la réunion, qui sert à déterminer le format de la date dans la description de l'événement du calendrier.

location
string

Le lieu physique ou virtuel où se tiendra la réunion.

webConferenceMeetingId
string

L'identifiant unique de la réunion de conférence Web.

webConferenceUrl
string

L'URL pour accéder à la conférence Web de la réunion.

Last modified on March 30, 2026