> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.jp/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create a new calendar event for a meeting > 関連付け、Eメールリマインダー、ミーティング オブジェクト プロパティー、タイムゾーンなどの必要な詳細を指定して、新しいカレンダーイベントやミーティングオブジェクトを作成します。 export const ScopesList = ({scopes = [], description = "この API には、次のいずれかのスコープが必要です。"}) => { if (!scopes || scopes.length === 0) { return null; } const sortedScopes = scopes.sort((a, b) => a.localeCompare(b)); return
{description}
{sortedScopes.map((scope, index) =>
{scope}
)}
; }; export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => { const translations = { header: "サポートされる製品", description: "次のいずれかの製品またはそれ以上が必要です。", productNames: { marketing: "Marketing Hub", sales: "Sales Hub", service: "Service Hub", cms: "Content Hub" }, tiers: { free: "無料ツール", starter: "Starter", professional: "Professional", enterprise: "Enterprise" } }; const translateTier = tier => { if (!tier) return ''; const lowerTier = tier.toLowerCase(); return translations.tiers[lowerTier] || tier; }; const products = [{ name: marketing ? translations.productNames.marketing : '', level: translateTier(marketingLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg", alt: "Marketing Hub" }, { name: sales ? translations.productNames.sales : '', level: translateTier(salesLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg", alt: "Sales Hub" }, { name: service ? translations.productNames.service : '', level: translateTier(serviceLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg", alt: "Service Hub" }, { name: cms ? translations.productNames.cms : '', level: translateTier(cmsLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg", alt: "Content Hub" }].filter(product => product.name && product.level); if (products.length === 0) return null; return
{translations.description}
{products.map((product, index) =>
{product.alt} {product.name} - {product.level}
)}
; }; ## OpenAPI ````yaml specs/2026-03/scheduler-meetings-v2026-03.json POST /scheduler/2026-03/meetings/calendar openapi: 3.0.1 info: title: Scheduler Meetings description: Meetings Service For HubSpot Sales version: 2026-03 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic paths: /scheduler/2026-03/meetings/calendar: post: tags: - Advanced summary: 新しいカレンダー ミーティング イベントを作成します。 description: >- 関連付け、Eメールリマインダー、ミーティング オブジェクト プロパティー、タイムゾーンなどの必要な詳細を指定して、新しいカレンダーイベントやミーティングオブジェクトを作成します。 operationId: post-/scheduler/2026-03/meetings/calendar parameters: - name: organizerUserId in: query description: '' required: true style: form explode: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ExternalCalendarMeetingEventCreateRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ExternalCalenderMeetingEventResponse' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.objects.contacts.highly_sensitive.write.v2 - oauth2: - tickets - oauth2: - crm.objects.commercepayments.write - oauth2: - crm.objects.goals.write - oauth2: - crm.objects.line_items.write - oauth2: - crm.objects.contacts.write - oauth2: - crm.objects.products.write - oauth2: - crm.objects.projects.write - oauth2: - crm.objects.contacts.sensitive.write.v2 - oauth2: - crm.objects.projects.sensitive.write - oauth2: - crm.objects.services.write - oauth2: - crm.objects.deals.sensitive.write.v2 - oauth2: - tickets.highly_sensitive.v2 - oauth2: - crm.objects.listings.write - oauth2: - crm.objects.appointments.sensitive.write.v2 - oauth2: - crm.objects.companies.write - oauth2: - crm.objects.courses.write - oauth2: - crm.objects.appointments.write - oauth2: - tickets.sensitive.v2 - oauth2: - crm.objects.deals.write - oauth2: - crm.objects.projects.highly_sensitive.write - oauth2: - crm.objects.companies.sensitive.write.v2 - oauth2: - crm.objects.deals.highly_sensitive.write.v2 - oauth2: - crm.objects.companies.highly_sensitive.write.v2 - oauth2: - meetings-write components: schemas: ExternalCalendarMeetingEventCreateRequest: required: - associations - emailReminderSchedule - properties - timezone type: object properties: associations: type: array items: $ref: '#/components/schemas/ExternalAssociationCreateRequest' emailReminderSchedule: $ref: '#/components/schemas/ExternalEmailReminderSchedule' properties: $ref: '#/components/schemas/ExternalCalendarMeetingEventCreateProperties' timezone: type: string description: ミーティングイベントで設定されるタイムゾーンプロパティー。 ExternalCalenderMeetingEventResponse: required: - createdAt - id - lastUpdatedAt - properties type: object properties: createdAt: type: string description: ミーティングイベントが最初に作成された日時（ISO 8601形式）。 format: date-time id: type: string description: ミーティングイベントの固有ID。 lastUpdatedAt: type: string description: ミーティングイベントが最後に更新された日時（ISO 8601形式）。 format: date-time properties: $ref: '#/components/schemas/ExternalCalendarMeetingEventResponseProperties' ExternalAssociationCreateRequest: required: - to - types type: object properties: to: $ref: '#/components/schemas/PublicObjectId' types: type: array items: $ref: '#/components/schemas/AssociationSpec' ExternalEmailReminderSchedule: required: - reminders - shouldIncludeInviteDescription type: object properties: reminders: type: array items: $ref: '#/components/schemas/ExternalReminder' shouldIncludeInviteDescription: type: boolean description: 招待の説明をリマインダーに含めるかどうか。 ExternalCalendarMeetingEventCreateProperties: required: - hs_meeting_end_time - hs_meeting_outcome - hs_meeting_start_time - hs_meeting_title - hs_timestamp - hubspot_owner_id type: object properties: hs_activity_type: type: string description: ミーティングのアクティビティータイプ。受け入れられる値はポータルで定義されたコールとミーティングのタイプに基づきます。 hs_attachment_ids: type: array items: type: string hs_attendee_owner_ids: type: array items: type: string hs_internal_meeting_notes: type: string description: ミーティングに関する内部メモ。 hs_meeting_body: type: string description: ミーティングとカレンダーイベントの説明。 hs_meeting_end_time: type: string description: ミーティングを終了する必要がある時刻（ISO 8601形式）。 format: date-time hs_meeting_location: type: string description: ミーティングが行われる場所の住所、オンラインの場所、または電話番号。 hs_meeting_location_type: type: string description: ミーティングの場所のタイプ。受け入れられる値：ADDRESS、CUSTOM、PHONE。 enum: - ADDRESS - CUSTOM - PHONE hs_meeting_outcome: type: string description: >- ミーティングの成果。受け入れられるデフォルト値：SCHEDULED、COMPLETED、RESCHEDULED、NO_SHOW、CANCELED。このプロパティーは追加のカスタム値が含まれるように変更できます。 hs_meeting_start_time: type: string description: ミーティングを開始する必要がある時刻（ISO 8601形式）。 format: date-time hs_meeting_title: type: string description: ミーティングとカレンダーイベントのタイトル。 hs_timestamp: type: string description: >- ミーティングを開始する必要がある時刻（ISO 8601形式）。この値は「hs_meeting_start_time」と同じである必要があります。 format: date-time hubspot_owner_id: type: string description: ミーティングをホスティングするHubSpotユーザーのownerId。 ExternalCalendarMeetingEventResponseProperties: required: - hs_engagement_source - hs_engagement_source_id - hs_meeting_end_time - hs_meeting_outcome - hs_meeting_start_time - hs_meeting_title - hs_timestamp type: object properties: hs_activity_type: type: string description: ミーティングのアクティビティータイプ。受け入れられる値はポータルで定義されたコールとミーティングのタイプに基づきます。 hs_attachment_ids: type: array items: type: string hs_attendee_owner_ids: type: array items: type: string hs_engagement_source: type: string description: エンゲージメントのソースで、常に「MEETINGS」になります。 enum: - 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 hs_engagement_source_id: type: string description: >- エンゲージメントを作成したプロセスに関連付けられたID。このAPIを使用してミーティングイベントを作成する際は必ず空にする必要があります。 hs_include_description_in_reminder: type: string description: リマインダーにミーティングの説明を含めるかどうか。 hs_internal_meeting_notes: type: string description: ミーティングに関する内部メモ。 hs_meeting_body: type: string description: ミーティングとカレンダーイベントの説明。 hs_meeting_end_time: type: string description: ミーティングの終了時刻（ISO 8601形式）。 format: date-time hs_meeting_external_url: type: string description: ミーティングのカレンダーイベントURL。 hs_meeting_location: type: string description: ミーティングが行われる場所の住所、オンラインの場所、または電話番号。 hs_meeting_location_type: type: string description: ミーティングの場所のタイプ。受け入れられる値：ADDRESS、CUSTOM、PHONE。 enum: - ADDRESS - CUSTOM - PHONE hs_meeting_outcome: type: string description: >- ミーティングの成果。受け入れられるデフォルト値：SCHEDULED、COMPLETED、RESCHEDULED、NO_SHOW、CANCELED。このプロパティーは追加のカスタム値が含まれるように変更できます。 hs_meeting_start_time: type: string description: ミーティングの開始時刻（ISO 8601形式）。 format: date-time hs_meeting_title: type: string description: ミーティングとカレンダーイベントのタイトル。 hs_timestamp: type: string description: >- ミーティングを開始する必要がある時刻（ISO 8601形式）。この値は「hs_meeting_start_time」と同じである必要があります。 format: date-time hs_unique_id: type: string description: 作成されたカレンダーイベントの固有ID。 hubspot_owner_id: type: string description: ミーティングをホスティングするHubSpotユーザーの担当者ID。 Error: required: - category - correlationId - message type: object properties: category: type: string description: エラーカテゴリー context: type: object additionalProperties: type: array items: type: string description: エラー条件に関する背景状況 example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: リクエストの固有ID。エラー報告またはサポートチケットには必ずこの値を含めてください format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: エラーに関する詳細情報 items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: エラーまたは推奨の修正手順に関するドキュメントが含まれる関連付けられたURIへのリンク名の対応付け message: type: string description: エラーと修正手順（該当する場合）を記した、人が理解できるメッセージ example: An error occurred subCategory: type: string description: エラーに関する具体的な詳細が含まれる特定のカテゴリー example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base PublicObjectId: required: - id type: object properties: id: type: string description: オブジェクトの固有ID。 description: Contains the Id of a Public Object AssociationSpec: required: - associationCategory - associationTypeId type: object properties: associationCategory: type: string description: 「HUBSPOT_DEFINED」など、関連付けのカテゴリー。 enum: - HUBSPOT_DEFINED - INTEGRATOR_DEFINED - USER_DEFINED - WORK associationTypeId: type: integer description: 特定のタイプの関連付けを表すID。 format: int32 description: >- Defines the type, direction, and details of the relationship between two CRM objects. ExternalReminder: required: - numberOfTimeUnits - timeUnit type: object properties: numberOfTimeUnits: type: integer description: リマインダーが送信されるときのミーティング開始前のtimeUnits数。 format: int32 timeUnit: type: string description: 受け入れられる値：WEEKS、DAYS、HOURS、MINUTES。 enum: - DAYS - HOURS - MINUTES - WEEKS ErrorDetail: required: - message type: object properties: code: type: string description: エラーの詳細に関連付けられているステータスコード context: type: object additionalProperties: type: array items: type: string description: エラー条件に関する背景状況 example: '{missingScopes=[scope1, scope2]}' in: type: string description: エラーが見つかったフィールドまたはパラメーターの名前。 message: type: string description: エラーと修正手順（該当する場合）を記した、人が理解できるメッセージ subCategory: type: string description: エラーに関する具体的な詳細が含まれる特定のカテゴリー responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: crm.objects.contacts.sensitive.write.v2: '' meetings-write: '' scheduler.meetings.meeting-link.read: '' ````