---
title: "Create Meeting"
method: POST
path: "/scheduler/2027-03-beta/meetings/calendar"
tags: ["Advanced"]
---

# Create Meeting

`POST /scheduler/2027-03-beta/meetings/calendar`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/scheduler/2027-03-beta/meetings/calendar`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.contacts.highly_sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.commercepayments.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.goals.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.line_items.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.contacts.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.products.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.projects.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.projects.sensitive.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.contacts.sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.services.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.deals.sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `tickets.highly_sensitive.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.listings.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.appointments.sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.companies.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.courses.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.appointments.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `tickets.sensitive.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.deals.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.projects.highly_sensitive.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.companies.sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.companies.highly_sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.deals.highly_sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.schemas.meetings.write`

Create a new calendar meeting event in the HubSpot system. This endpoint allows you to schedule meetings by providing necessary details such as meeting title, start and end times, and associated user information. It is essential for organizing meetings and managing schedules within the HubSpot platform.

## Query parameters

- `organizerUserId` string, required

## Request body

- ExternalCalendarMeetingEventCreateRequest
  - `associations` ExternalAssociationCreateRequest[], required: An array of association objects that link the meeting event to other HubSpot objects, such as contacts or deals.
    - `to` PublicObjectId, required: Contains the Id of a Public Object
      - `id` string, required: The unique identifier for the public object, represented as a string.
    - `types` AssociationSpec[], required: An array of association specifications that define the types of associations to be created. Each item in the array is a reference to an AssociationSpec schema.
      - `associationCategory` 'HUBSPOT_DEFINED' | 'INTEGRATOR_DEFINED' | 'USER_DEFINED' | 'WORK', required: A string representing the category of the association. Valid values include 'HUBSPOT_DEFINED', 'USER_DEFINED', 'INTEGRATOR_DEFINED', and 'WORK'.
      - `associationTypeId` integer, required: An integer representing the unique identifier for the type of association.
  - `emailReminderSchedule` ExternalEmailReminderSchedule, required
    - `reminders` ExternalReminder[], required: An array of reminder objects, each specifying the timing for sending a reminder before the meeting. Each reminder includes the number of time units and the type of time unit (e.g., weeks, days, hours, minutes).
      - `numberOfTimeUnits` integer, required: The number of units of time before the meeting when the reminder should be sent. This is an integer value.
      - `timeUnit` 'DAYS' | 'HOURS' | 'MINUTES' | 'WEEKS', required: The unit of time used for the reminder. Valid values include 'WEEKS', 'DAYS', 'HOURS', and 'MINUTES'.
    - `shouldIncludeInviteDescription` boolean, required: A boolean indicating whether the meeting invite description should be included in the email reminders.
  - `properties` ExternalCalendarMeetingEventCreateProperties, required
    - `hs_activity_type` string: The type of activity for the meeting. It is a string value.
    - `hs_attachment_ids` string[]: An array of attachment IDs associated with the meeting. Each ID is a string.
    - `hs_attendee_owner_ids` string[]: An array of owner IDs for the attendees of the meeting. Each ID is a string.
    - `hs_internal_meeting_notes` string: Internal notes for the meeting. It is a string value.
    - `hs_meeting_body` string: The body content or description of the meeting. It is a string value.
    - `hs_meeting_end_time` string, date-time, required: The end time of the meeting, in ISO 8601 date-time format.
    - `hs_meeting_location` string: The location of the meeting. It is a string value.
    - `hs_meeting_location_type` 'ADDRESS' | 'CUSTOM' | 'PHONE': The type of location for the meeting. Valid values include 'PHONE', 'ADDRESS', and 'CUSTOM'.
    - `hs_meeting_outcome` string, required: The outcome of the meeting. It is a string value.
    - `hs_meeting_start_time` string, date-time, required: The start time of the meeting, in ISO 8601 date-time format.
    - `hs_meeting_title` string, required: The title of the meeting. It is a string value.
    - `hs_timestamp` string, date-time, required: The timestamp of the meeting event creation, in ISO 8601 date-time format.
    - `hubspot_owner_id` string, required: The unique identifier of the HubSpot owner associated with the meeting. It is a string value.
  - `timezone` string, required: A string representing the timezone in which the meeting is scheduled.

## Response `200`

successful operation

- ExternalCalenderMeetingEventResponse
  - `createdAt` string, date-time, required: The date and time when the meeting event was created, in ISO 8601 format.
  - `id` string, required: The unique identifier for the meeting event, represented as a string.
  - `lastUpdatedAt` string, date-time, required: The date and time when the meeting event was last updated, in ISO 8601 format.
  - `properties` ExternalCalendarMeetingEventResponseProperties, required
    - `hs_activity_type` string: The type of activity associated with the meeting event.
    - `hs_attachment_ids` string[]: An array of unique identifiers for attachments associated with the meeting event.
    - `hs_attendee_owner_ids` string[]: An array of unique identifiers for the owners of attendees associated with the meeting event.
    - `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' | 'CUSTOMER_PORTAL' | '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 for the meeting event. Valid values include a wide range of sources such as 'UNKNOWN', 'IMPORT', 'API', 'FORM', and many others.
    - `hs_engagement_source_id` string, required: The unique identifier for the source of the engagement.
    - `hs_include_description_in_reminder` string: Indicates whether the meeting description should be included in reminders.
    - `hs_internal_meeting_notes` string: Internal notes related to the meeting event.
    - `hs_meeting_body` string: The body or description of the meeting event.
    - `hs_meeting_end_time` string, date-time, required: The end time of the meeting event, in ISO 8601 format.
    - `hs_meeting_external_url` string: The external URL associated with the meeting event.
    - `hs_meeting_location` string: The location where the meeting event is held.
    - `hs_meeting_location_type` 'ADDRESS' | 'CUSTOM' | 'PHONE': The type of location for the meeting event. Valid values include 'PHONE', 'ADDRESS', and 'CUSTOM'.
    - `hs_meeting_outcome` string, required: The outcome of the meeting event.
    - `hs_meeting_start_time` string, date-time, required: The start time of the meeting event, in ISO 8601 format.
    - `hs_meeting_title` string, required: The title of the meeting event.
    - `hs_timestamp` string, date-time, required: A timestamp indicating when the meeting event was created or last updated, in ISO 8601 format.
    - `hs_unique_id` string: A unique identifier for the meeting event.
    - `hubspot_owner_id` string: The unique identifier of the HubSpot owner associated with the meeting event.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-14** (2027-03-beta) `6d3443ad681b`: 2 info
  - the security scope `crm.objects.contacts.highly_sensitive.write.v2` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.schemas.meetings.write` was removed from the endpoint's security scheme `oauth2`
- **2026-10-10** (2027-03-beta) `a9440c8f9a36`: 2 info
  - the security scope `crm.objects.contacts.highly_sensitive.write.v2` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.schemas.meetings.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-16** (2027-03-beta) `a9440c8f9a36`: 2 info
  - the security scope `crm.objects.contacts.highly_sensitive.write.v2` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.schemas.meetings.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-09** (2027-03-beta) `db0398c13d8e`: 2 info
  - the security scope `crm.objects.contacts.highly_sensitive.write.v2` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.schemas.meetings.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-07** (2027-03-beta) `4f2b0a602c9a`: 2 info
  - the security scope `crm.objects.contacts.highly_sensitive.write.v2` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.schemas.meetings.write` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/scheduler-meetings/changes/scheduler/2027-03-beta/meetings/calendar/post.md)

---

[API](https://skmtc.dev/hubspot/apis/scheduler-meetings.md) - [All operations](https://skmtc.dev/hubspot/apis/scheduler-meetings/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/scheduler-meetings/revisions/6d3443ad681b?raw)