---
title: "Create a new calendar meeting event."
method: POST
path: "/scheduler/2026-03/meetings/calendar"
tags: ["Advanced"]
---

# Create a new calendar meeting event.

`POST /scheduler/2026-03/meetings/calendar`

Create a new calendar event and meeting object by providing the necessary details such as associations, email reminders, meeting object properties, and timezone.

## Query parameters

- `organizerUserId` string, required

## Request body

- SchedulerMeetingsExternalCalendarMeetingEventCreateRequest
  - `associations` SchedulerMeetingsExternalAssociationCreateRequest[], required
    - `to` PublicObjectId, required — Contains the Id of a Public Object
      - `id` string, required — The unique identifier for the public object.
    - `types` AssociationSpec[], required
      - `associationCategory` 'HUBSPOT_DEFINED' | 'INTEGRATOR_DEFINED' | 'USER_DEFINED' | 'WORK', required — The category of the association, such as "HUBSPOT_DEFINED".
      - `associationTypeId` integer, required — The ID representing the specific type of association.
  - `emailReminderSchedule` SchedulerMeetingsExternalEmailReminderSchedule, required
    - `reminders` SchedulerMeetingsExternalReminder[], required
      - `numberOfTimeUnits` integer, required — The number of timeUnits prior to the meeting start when the reminder will be sent.
      - `timeUnit` 'DAYS' | 'HOURS' | 'MINUTES' | 'WEEKS', required — Accepted values are: WEEKS, DAYS, HOURS, MINUTES.
    - `shouldIncludeInviteDescription` boolean, required — Whether the invite description should be included in the reminder.
  - `properties` SchedulerMeetingsExternalCalendarMeetingEventCreateProperties, required
    - `hs_activity_type` string — The activity type of the meeting. Acceptable values are based on portal defined call and meeting types.
    - `hs_attachment_ids` string[]
    - `hs_attendee_owner_ids` string[]
    - `hs_internal_meeting_notes` string — Internal notes related to the meeting.
    - `hs_meeting_body` string — The description of the meeting and calendar event.
    - `hs_meeting_end_time` string, date-time, required — The time that the meeting should end in ISO 8601 format.
    - `hs_meeting_location` string — The physical address, virtual location, or phone number where the meeting will take place.
    - `hs_meeting_location_type` 'ADDRESS' | 'CUSTOM' | 'PHONE' — The type of location for the meeting. Acceptable values are: ADDRESS, CUSTOM, PHONE.
    - `hs_meeting_outcome` string, required — The outcome of the meeting. Acceptable default values are: SCHEDULED, COMPLETED, RESCHEDULED, NO_SHOW, CANCELED. This property can be changed to include additional custom values.
    - `hs_meeting_start_time` string, date-time, required — The time that the meeting should start in ISO 8601 format.
    - `hs_meeting_title` string, required — The title of the meeting and calendar event.
    - `hs_timestamp` string, date-time, required — The time that the meeting should start in ISO 8601 format. This value should be the same as `hs_meeting_start_time`.
    - `hubspot_owner_id` string, required — The ownerId of the HubSpot user who will host the meeting.
  - `timezone` string, required — The timezone property that will be set on the meeting event.

## Response `200`

successful operation

- SchedulerMeetingsExternalCalenderMeetingEventResponse
  - `createdAt` string, date-time, required — The date and time when the meeting event was initially created, in ISO 8601 format.
  - `id` string, required — The unique identifier for the meeting event.
  - `lastUpdatedAt` string, date-time, required — The date and time when the meeting event was last updated, in ISO 8601 format.
  - `properties` SchedulerMeetingsExternalCalendarMeetingEventResponseProperties, required
    - `hs_activity_type` string — The activity type of the meeting. Acceptable values are based on portal defined call and meeting types.
    - `hs_attachment_ids` string[]
    - `hs_attendee_owner_ids` string[]
    - `hs_engagement_source` 'ACADEMY' | 'ACCEPTANCE_TEST' | 'ACTIVITY_AUTO_ASSOCIATE' | 'ACTIVITY_LOG_REVERT' | 'ADS' | 'AI_GROUP' | 'ANALYTICS' | 'API' | 'APPROVALS' | 'ASSISTS' | 'ASSOCIATIONS' | 'AUTO_ASSOCIATE_BY_DOMAIN' | 'AUTOMATION_JOURNEY' | 'AUTOMATION_PLATFORM' | 'AVATARS_SERVICE' | 'BATCH_UPDATE' | 'BCC_TO_CRM' | 'BEHAVIORAL_EVENTS' | 'BET_ASSIGNMENT' | 'BET_CRM_CONNECTOR' | 'BIDEN' | 'BILLING' | 'BOT' | 'BREEZE_AGENT' | 'CALCULATED' | 'CENTRAL_EXCHANGE_RATES' | 'CHATSPOT' | 'CLONE_OBJECTS' | 'COMMUNICATOR' | 'COMPANIES' | 'COMPANY_FAMILIES' | 'COMPANY_INSIGHTS' | 'CONNECTED_ACCOUNT' | 'CONTACTS' | 'CONTACTS_WEB' | 'CONTENT_MEMBERSHIP' | 'CONVERSATIONAL_ENRICHMENT' | 'CONVERSATIONS' | 'CRM_PROCESSES_PLATFORM' | 'CRM_UI' | 'CRM_UI_BULK_ACTION' | 'CUSTOMER_AGENT' | 'DATA_ENRICHMENT' | 'DATA_QUALITY' | 'DATASET' | 'DEALS' | 'DEFAULT' | 'DELETE_OBJECTS' | 'DI_WRITE_TO_CRM' | 'EMAIL' | 'EMAIL_INBOX_IMPORT' | 'EMAIL_INTEGRATION' | 'ENGAGEMENTS' | 'EXTENSION' | 'FILE_MANAGER' | 'FLYWHEEL_PRODUCT_DATA_SYNC' | 'FORECASTING' | 'FORM' | 'FORWARD_TO_CRM' | 'GMAIL_INTEGRATION' | 'GOALS' | 'HEISENBERG' | 'HELP_DESK' | 'HELP_DESK_AI' | 'IMPORT' | 'INTEGRATION' | 'INTEGRATIONS_PLATFORM' | 'INTEGRATIONS_SYNC' | 'INTENT' | 'INTERNAL_PROCESSING' | 'LEADIN' | 'LEGAL_BASIS_REMEDIATION' | 'MARKET_SOURCING' | 'MARKETPLACE' | 'MARKETS' | 'MEETINGS' | 'MERGE_COMPANIES' | 'MERGE_CONTACTS' | 'MERGE_OBJECTS' | 'MERGE_REVERT_OBJECTS' | 'MICROAPPS' | 'MIGRATION' | 'MOBILE_ANDROID' | 'MOBILE_IOS' | 'PAYMENTS' | 'PIPELINE_SETTINGS' | 'PLAYBOOKS' | 'PORTAL_OBJECT_SYNC' | 'PORTAL_USER_ASSOCIATOR' | 'PRESENTATIONS' | 'PRIMARY_AUTOMATION' | 'PROPERTY_DEFAULT_VALUE' | 'PROPERTY_RESTORE' | 'PROPERTY_SETTINGS' | 'PROSPECTING_AGENT' | 'QUOTAS' | 'QUOTES' | 'RECYCLING_BIN' | 'RESTORE_OBJECTS' | 'REVENUE_PLATFORM' | 'SALES' | 'SALES_MESSAGES' | 'SALESFORCE' | 'SEQUENCES' | 'SETTINGS' | 'SIDEKICK' | 'SIGNALS' | 'SLACK_INTEGRATION' | 'SMART_DATA_CAPTURE' | 'SOCIAL' | 'SUCCESS' | 'TALLY' | 'TASK' | 'UNKNOWN' | 'WAL_INCREMENTAL' | 'WORK_UI' | 'WORKFLOW_CONTACT_DELETE_ACTION' | 'WORKFLOWS', required — The source of the engagement, will always be `MEETINGS`.
    - `hs_engagement_source_id` string, required — The ID associated with the process created the engagement. Should always be empty when creating meeting events through this API.
    - `hs_include_description_in_reminder` string — Whether to include the meeting description in the reminder.
    - `hs_internal_meeting_notes` string — Internal notes related to the meeting.
    - `hs_meeting_body` string — The description of the meeting and calendar event.
    - `hs_meeting_end_time` string, date-time, required — The end time of the meeting in ISO 8601 format.
    - `hs_meeting_external_url` string — The calendar event URL for the meeting.
    - `hs_meeting_location` string — The physical address, virtual location, or phone number where the meeting will take place.
    - `hs_meeting_location_type` 'ADDRESS' | 'CUSTOM' | 'PHONE' — The type of location for the meeting. Acceptable values are: ADDRESS, CUSTOM, PHONE.
    - `hs_meeting_outcome` string, required — The outcome of the meeting. Acceptable default values are: SCHEDULED, COMPLETED, RESCHEDULED, NO_SHOW, CANCELED. This property can be changed to include additional custom values.
    - `hs_meeting_start_time` string, date-time, required — The start time of the meeting in ISO 8601 format.
    - `hs_meeting_title` string, required — The title of the meeting and calendar event.
    - `hs_timestamp` string, date-time, required — The time that the meeting should start in ISO 8601 format. This value should be the same as `hs_meeting_start_time`.
    - `hs_unique_id` string — The unique ID of the created calendar event.
    - `hubspot_owner_id` string — The owner ID of the HubSpot user hosting the meeting.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/f9c7181056c5/schema)