Book a meeting

Réserver une réunion

curl --request POST \
  --url https://api.hubapi.com/scheduler/2026-03/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>"
}
'

import requests

url = "https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book"

payload = {
    "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>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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>'
  })
};

fetch('https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book"

	payload := strings.NewReader("{\n  \"duration\": 123,\n  \"email\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"formFields\": [\n    {\n      \"name\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"lastName\": \"<string>\",\n  \"legalConsentResponses\": [\n    {\n      \"communicationTypeId\": \"<string>\",\n      \"consented\": true\n    }\n  ],\n  \"likelyAvailableUserIds\": [\n    \"<string>\"\n  ],\n  \"slug\": \"<string>\",\n  \"startTime\": \"2023-11-07T05:31:56Z\",\n  \"locale\": \"<string>\",\n  \"timezone\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"duration\": 123,\n  \"email\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"formFields\": [\n    {\n      \"name\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"lastName\": \"<string>\",\n  \"legalConsentResponses\": [\n    {\n      \"communicationTypeId\": \"<string>\",\n      \"consented\": true\n    }\n  ],\n  \"likelyAvailableUserIds\": [\n    \"<string>\"\n  ],\n  \"slug\": \"<string>\",\n  \"startTime\": \"2023-11-07T05:31:56Z\",\n  \"locale\": \"<string>\",\n  \"timezone\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"duration\": 123,\n  \"email\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"formFields\": [\n    {\n      \"name\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"lastName\": \"<string>\",\n  \"legalConsentResponses\": [\n    {\n      \"communicationTypeId\": \"<string>\",\n      \"consented\": true\n    }\n  ],\n  \"likelyAvailableUserIds\": [\n    \"<string>\"\n  ],\n  \"slug\": \"<string>\",\n  \"startTime\": \"2023-11-07T05:31:56Z\",\n  \"locale\": \"<string>\",\n  \"timezone\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "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>"
}

{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

POST

scheduler

2026-03

meetings

meeting-links

book

Réserver une réunion

curl --request POST \
  --url https://api.hubapi.com/scheduler/2026-03/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>"
}
'

import requests

url = "https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book"

payload = {
    "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>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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>'
  })
};

fetch('https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book"

	payload := strings.NewReader("{\n  \"duration\": 123,\n  \"email\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"formFields\": [\n    {\n      \"name\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"lastName\": \"<string>\",\n  \"legalConsentResponses\": [\n    {\n      \"communicationTypeId\": \"<string>\",\n      \"consented\": true\n    }\n  ],\n  \"likelyAvailableUserIds\": [\n    \"<string>\"\n  ],\n  \"slug\": \"<string>\",\n  \"startTime\": \"2023-11-07T05:31:56Z\",\n  \"locale\": \"<string>\",\n  \"timezone\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"duration\": 123,\n  \"email\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"formFields\": [\n    {\n      \"name\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"lastName\": \"<string>\",\n  \"legalConsentResponses\": [\n    {\n      \"communicationTypeId\": \"<string>\",\n      \"consented\": true\n    }\n  ],\n  \"likelyAvailableUserIds\": [\n    \"<string>\"\n  ],\n  \"slug\": \"<string>\",\n  \"startTime\": \"2023-11-07T05:31:56Z\",\n  \"locale\": \"<string>\",\n  \"timezone\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/scheduler/2026-03/meetings/meeting-links/book")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"duration\": 123,\n  \"email\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"formFields\": [\n    {\n      \"name\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"lastName\": \"<string>\",\n  \"legalConsentResponses\": [\n    {\n      \"communicationTypeId\": \"<string>\",\n      \"consented\": true\n    }\n  ],\n  \"likelyAvailableUserIds\": [\n    \"<string>\"\n  ],\n  \"slug\": \"<string>\",\n  \"startTime\": \"2023-11-07T05:31:56Z\",\n  \"locale\": \"<string>\",\n  \"timezone\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "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>"
}

{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

Supported products

Required Scopes

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

Un entier représentant la durée de la réunion en minutes.

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

Un tableau de champs de formulaire remplis par lela participante, chacun contenant un nom et une valeur.

Show child attributes

lastName

string

requis

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

Un tableau de réponses de consentement légal, chacune détaillant le consentement donné par le participant.

Show child attributes

likelyAvailableUserIds

string[]

requis

Un tableau de chaînes de caractères représentant les identifiants d'utilisateurrices susceptibles d'être disponibles pour la réunion.

slug

string

requis

Une chaîne représentant l'identifiant unique du lien de prise de rendez-vous.

startTime

string<date-time>

requis

L'heure de début de la réunion au format de date et d'heure ISO 8601.

locale

string

Une chaîne de caractères représentant les paramètres régionaux de la personne qui réserve la réunion.

timezone

string

Une chaîne représentant le fuseau horaire de la personne qui réserve la réunion.

Réponse

successful operation

bookingTimezone

string

requis

Le fuseau horaire dans lequel la réunion a été réservée, représenté sous forme de chaîne.

calendarEventId

string

requis

L'identifiant unique de l'événement de calendrier associé à cette réunion.

contactId

string

requis

L'identifiant unique du contact associé à cette réunion.

duration

integer<int64>

requis

La durée de la réunion en minutes, représentée par un entier.

end

string<date-time>

requis

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

formFields

object[]

requis

Un tableau de champs de formulaire validés soumis pendant le processus de réservation, chacun représenté par un objet ExternalValidatedFormField.

Show child attributes

guestEmails

string[]

requis

Une liste d'adresses e-mail des invité·e·s à la réunion.

isOffline

boolean

requis

Un booléen indiquant si la réunion est hors ligne (vrai) ou en ligne (faux).

Un ensemble de réponses de consentement légal associées à la réunion, chacune représentée par un objet ExternalLegalConsentResponse.

Show child attributes

start

string<date-time>

requis

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

subject

string

requis

Le sujet ou le titre de la réunion, représenté sous forme de chaîne.

locale

string

Le paramètre régional de la réunion, représenté sous forme de chaîne.

location

string

Le lieu de la réunion, représenté sous forme de chaîne.

webConferenceMeetingId

string

L'identifiant unique de la réunion de conférence web, le cas échéant.

webConferenceUrl

string

L'URL de la conférence web associée à la réunion, le cas échéant.

Dernière modification le 1 avril 2026

⌘I

Account & Settings

Gestion des applications

Authentification

Automatisation

CMS

Préférences de communication

Conversations

CRM

Événements

Fichiers

Marketing

Planificateur

Webhooks

Autorisations

Corps

Réponse