Zum Hauptinhalt springen
POST
/
scheduler
/
v3
/
meetings
/
meeting-links
/
book
Ein Meeting buchen
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>"
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos

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

Die Dauer des Meetings in Millisekunden.

email
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
lastName
string
erforderlich

Der Nachname der Person, die das Meeting gebucht hat.

likelyAvailableUserIds
string[]
erforderlich
slug
string
erforderlich

Die eindeutige Pfad-ID für die Meetingseite.

startTime
string<date-time>
erforderlich

Der Zeitpunkt (Datum und Uhrzeit), zu dem das Meeting starten soll (Format ISO 8601).

locale
string

Das für die Formatierung von Datums- und Zeitangaben im gebuchten Meeting verwendete Gebietsschema.

timezone
string

Die Zeitzone, in der das Meeting geplant ist.

Antwort

successful operation

bookingTimezone
string
erforderlich

Die Zeitzone, in der das Meeting gebucht wurde.

calendarEventId
string
erforderlich

Die eindeutige ID für das Kalender-Event des Meetings.

contactId
string
erforderlich

Die ID des Kontakts, der dem Meeting zugeordnet ist.

duration
integer<int64>
erforderlich

Die Dauer des Meetings in Millisekunden.

end
string<date-time>
erforderlich

Der Zeitpunkt (Datum und Uhrzeit), zu dem das Meeting enden soll (Format ISO 8601).

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

Ob das Meeting offline gebucht und kein zugehöriges Kalender-Event erstellt wurde.

start
string<date-time>
erforderlich

Der Zeitpunkt (Datum und Uhrzeit), zu dem das Meeting starten soll (Format ISO 8601).

subject
string
erforderlich

Der Titel des Meeting- und Kalender-Events.

locale
string

Das Gebietsschema, in dem das Meeting gebucht wurde, wird verwendet, um das Datumsformat in der Beschreibung des Kalender-Events festzulegen.

location
string

Die physische Adresse oder der virtuelle Ort, an der bzw. unter der das Meeting stattfinden wird.

webConferenceMeetingId
string

Die eindeutige ID für das Webkonferenzmeeting.

webConferenceUrl
string

Die URL für den Zugriff auf das Webkonferenzmeeting.

Last modified on March 24, 2026