メインコンテンツへスキップ
POST
/
scheduler
/
v3
/
meetings
/
meeting-links
/
book
ミーティングを予約
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>"
}

サポートされる製品

次のいずれかの製品またはそれ以上が必要です。
Marketing HubMarketing Hub -無料ツール
Sales HubSales Hub -無料ツール
Service HubService Hub -無料ツール
Content HubContent Hub -無料ツール

承認

Authorization
string
header
必須

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

ボディ

application/json
duration
integer<int64>
必須

ミーティングの所要時間(ミリ秒)。

email
string
必須

ミーティングを予約した個人のEメールアドレス。

firstName
string
必須

ミーティングを予約した個人の名。

formFields
object[]
必須
lastName
string
必須

ミーティングを予約した個人の姓。

likelyAvailableUserIds
string[]
必須
slug
string
必須

ミーティングページの固有経路ID。

startTime
string<date-time>
必須

ミーティングの開始が予定されている日時(ISO 8601形式)。

locale
string

ミーティング予約で日時の書式設定に使用されるロケール。

timezone
string

ミーティングがスケジュールされているタイムゾーン。

レスポンス

successful operation

bookingTimezone
string
必須

ミーティングが予約されたタイムゾーン。

calendarEventId
string
必須

ミーティングのカレンダーイベントの固有ID。

contactId
string
必須

ミーティングに関連付けられているコンタクトのID。

duration
integer<int64>
必須

ミーティングの所要時間(ミリ秒)。

end
string<date-time>
必須

ミーティングの終了が予定されている日時(ISO 8601形式)。

formFields
object[]
必須
guestEmails
string[]
必須
isOffline
boolean
必須

ミーティングがオフラインで予約され、関連付けられたカレンダーイベントが作成されていないかどうか。

start
string<date-time>
必須

ミーティングの開始が予定されている日時(ISO 8601形式)。

subject
string
必須

ミーティングとカレンダーイベントのタイトル。

locale
string

ミーティングの予約に使用されたロケール。カレンダーイベントの説明での日付の書式設定の決定に使用されます。

location
string

ミーティングが行われる場所の住所またはオンラインの場所。

webConferenceMeetingId
string

ウェブ会議ミーティングの固有ID。

webConferenceUrl
string

ミーティングのウェブ会議にアクセスするためのURL。

Last modified on March 30, 2026