Book a meeting

Meeting buchen

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

Meeting buchen

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

Autorisierungen

Authorization

string

header

erforderlich

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

Body

application/json

duration

integer<int64>

erforderlich

Eine Ganzzahl, die die Dauer des Meetings in Minuten angibt.

string

erforderlich

Die E-Mail-Adresse der Person, die das Meeting gebucht hat.

firstName

string

erforderlich

Der Vorname der Person, die das Meeting gebucht hat.

formFields

object[]

erforderlich

Ein Array von Formularfeldern, die vom Teilnehmer ausgefüllt wurden und jeweils einen Namen und einen Wert enthalten.

Show child attributes

lastName

string

erforderlich

Der Nachname der Person, die das Meeting gebucht hat.

Ein Array von Antworten zur rechtlichen Einwilligung, die jeweils die vom Teilnehmer erteilte Einwilligung detailliert beschreiben.

Show child attributes

likelyAvailableUserIds

string[]

erforderlich

Ein Array von Zeichenfolgen, die die Benutzer-IDs derjenigen Benutzer darstellen, die wahrscheinlich für das Meeting verfügbar sind.

slug

string

erforderlich

Eine Zeichenfolge, die die eindeutige ID für den Meetinglink darstellt.

startTime

string<date-time>

erforderlich

Die Startzeit des Meeting im ISO 8601-Format für Datum und Uhrzeit.

locale

string

Eine Zeichenfolge, die das Gebietsschema der Person angibt, die das Meeting bucht.

timezone

string

Eine Zeichenfolge, die die Zeitzone der Person darstellt, die das Meeting bucht.

Antwort

successful operation

bookingTimezone

string

erforderlich

Die Zeitzone, in der das Meeting gebucht wurde, dargestellt als Zeichenfolge.

calendarEventId

string

erforderlich

Die eindeutige ID für das Kalender-Event, das diesem Meeting zugeordnet ist.

contactId

string

erforderlich

Die eindeutige ID für den Kontakt, der diesem Meeting zugeordnet ist.

duration

integer<int64>

erforderlich

Die Dauer des Meetings in Minuten, dargestellt als Ganzzahl.

end

string<date-time>

erforderlich

Der Endzeitpunkt (Datum und Uhrzeit) des Meetings im ISO 8601-Format.

formFields

object[]

erforderlich

Ein Array von validierten Formularfeldern, die während des Buchungsprozesses übermittelt wurden und jeweils durch ein ExternalValidatedFormField-Objekt dargestellt werden.

Show child attributes

guestEmails

string[]

erforderlich

Ein Array von E-Mail-Adressen der zum Meeting eingeladenen Gäste.

isOffline

boolean

erforderlich

Ein boolescher Wert, der angibt, ob das Meeting offline (true) oder online (false) ist.

Ein Array von Antworten zur rechtlichen Einwilligung, die dem Meeting zugeordnet sind und jeweils durch ein ExternalLegalConsentResponse-Objekt dargestellt werden.

Show child attributes

start

string<date-time>

erforderlich

Der Startzeitpunkt (Datum und Uhrzeit) des Meetings im ISO 8601-Format.

subject

string

erforderlich

Der Betreff oder Titel des Meetings, dargestellt als Zeichenfolge.

locale

string

Die Gebietsschemaeinstellung für das Meeting, dargestellt als Zeichenfolge.

location

string

Der Ort des Meetings, dargestellt als Zeichenfolge.

webConferenceMeetingId

string

Die eindeutige Kennung für das Webkonferenz-Meeting, falls zutreffend.

webConferenceUrl

string

Die URL für die dem Meeting zugeordnete Webkonferenz, falls zutreffend.

Zuletzt geändert am 1. April 2026

Account & Einstellungen

App-Verwaltung

Authentifizierung

Automatisierung

CMS

Kommunikationseinstellungen

Konversationen

CRM

Veranstaltungen

Dateien

Marketing

Zeitplaner

Webhooks

Autorisierungen

Body

Antwort