Create a new calendar event for a meeting

Erstellen Sie ein neues Kalender-Event und ein neues Meetingobjekt, indem Sie die erforderlichen Details wie Zuordnungen, E-Mail-Erinnerungen, Eigenschaften des Meetingobjekts und Zeitzone angeben.

POST /scheduler/2026-03/meetings/calendar

Erstellen Sie ein neues Kalender-Meetingevent.

cURL

curl --request POST \
  --url https://api.hubapi.com/scheduler/2026-03/meetings/calendar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "associations": [
    {
      "to": {
        "id": "<string>"
      },
      "types": [
        {
          "associationCategory": "HUBSPOT_DEFINED",
          "associationTypeId": 123
        }
      ]
    }
  ],
  "emailReminderSchedule": {
    "reminders": [
      {
        "numberOfTimeUnits": 123,
        "timeUnit": "DAYS"
      }
    ],
    "shouldIncludeInviteDescription": true
  },
  "properties": {
    "hs_meeting_end_time": "2023-11-07T05:31:56Z",
    "hs_meeting_outcome": "<string>",
    "hs_meeting_start_time": "2023-11-07T05:31:56Z",
    "hs_meeting_title": "<string>",
    "hs_timestamp": "2023-11-07T05:31:56Z",
    "hubspot_owner_id": "<string>",
    "hs_activity_type": "<string>",
    "hs_attachment_ids": [
      "<string>"
    ],
    "hs_attendee_owner_ids": [
      "<string>"
    ],
    "hs_internal_meeting_notes": "<string>",
    "hs_meeting_body": "<string>",
    "hs_meeting_location": "<string>",
    "hs_meeting_location_type": "ADDRESS"
  },
  "timezone": "<string>"
}
'

200

{
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "lastUpdatedAt": "2023-11-07T05:31:56Z",
  "properties": {
    "hs_engagement_source": "ACADEMY",
    "hs_engagement_source_id": "<string>",
    "hs_meeting_end_time": "2023-11-07T05:31:56Z",
    "hs_meeting_outcome": "<string>",
    "hs_meeting_start_time": "2023-11-07T05:31:56Z",
    "hs_meeting_title": "<string>",
    "hs_timestamp": "2023-11-07T05:31:56Z",
    "hs_activity_type": "<string>",
    "hs_attachment_ids": [
      "<string>"
    ],
    "hs_attendee_owner_ids": [
      "<string>"
    ],
    "hs_include_description_in_reminder": "<string>",
    "hs_internal_meeting_notes": "<string>",
    "hs_meeting_body": "<string>",
    "hs_meeting_external_url": "<string>",
    "hs_meeting_location": "<string>",
    "hs_meeting_location_type": "ADDRESS",
    "hs_unique_id": "<string>",
    "hubspot_owner_id": "<string>"
  }
}

Supported products

Required Scopes

Autorisierungen

Authorization · string · header · erforderlich

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

Abfrageparameter

organizerUserId · string · erforderlich

Der HubSpot-Benutzer, der als Ersteller des Meeting-Events behandelt wird

Body

application/json

associations · object[] · erforderlich

Show child attributes

emailReminderSchedule · object · erforderlich

Show child attributes

properties · object · erforderlich

Show child attributes

timezone · string · erforderlich

Die Zeitzoneneigenschaft, die für das Meetingevent festgelegt wird.

Antwort

200

application/json

successful operation

createdAt · string<date-time> · erforderlich

Der Zeitpunkt (Datum und Uhrzeit), zu dem das Meetingevent ursprünglich erstellt wurde (Format ISO 8601).

id · string · erforderlich

Die eindeutige ID für das Meetingevent.

lastUpdatedAt · string<date-time> · erforderlich

Der Zeitpunkt (Datum und Uhrzeit), zu dem das Meetingevent zuletzt aktualisiert wurde (Format ISO 8601).

properties · object · erforderlich

Show child attributes