> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create a new calendar event for a meeting > Créez un nouvel événement de calendrier et un nouvel objet de réunion en fournissant les détails nécessaires tels que les associations, les rappels par e-mail, les propriétés de l'objet de réunion et le fuseau horaire. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/legacy/v3/scheduler-meetings-v3.json POST /scheduler/v3/meetings/calendar openapi: 3.0.1 info: title: Scheduler Meetings description: Meetings Service For HubSpot Sales version: v3 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-related-documentation: - name: Meetings guide url: >- https://developers.hubspot.com/docs/reference/api/crm/engagements/meetings servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic paths: /scheduler/v3/meetings/calendar: post: tags: - Advanced summary: Créer un nouvel événement de réunion dans le calendrier. description: >- Créez un nouvel événement de calendrier et un nouvel objet de réunion en fournissant les détails nécessaires tels que les associations, les rappels par e-mail, les propriétés de l'objet de réunion et le fuseau horaire. operationId: post-/scheduler/v3/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: '' deprecated: true security: - oauth2: - crm.objects.contacts.highly_sensitive.write.v2 - 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.projects.sensitive.write - oauth2: - crm.objects.contacts.sensitive.write.v2 - 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.companies.highly_sensitive.write.v2 - oauth2: - crm.objects.deals.highly_sensitive.write.v2 - oauth2: - crm.schemas.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: >- La propriété de fuseau horaire qui sera définie pour l'événement de réunion. ExternalCalenderMeetingEventResponse: required: - createdAt - id - lastUpdatedAt - properties type: object properties: createdAt: type: string description: "La date et l'heure de la création initiale de l'événement de réunion, au format ISO\_8601." format: date-time id: type: string description: Identifiant unique de l'événement de réunion. lastUpdatedAt: type: string description: "La date et l'heure de la dernière mise à jour de la réunion, au format 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: Si la description de l'invitation doit être incluse dans le rappel. 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: >- Type d'activité de la réunion. Les valeurs acceptables sont fondées sur les types d'appels et de réunions définis par le portail. hs_attachment_ids: type: array items: type: string hs_attendee_owner_ids: type: array items: type: string hs_internal_meeting_notes: type: string description: Notes internes relatives à la réunion. hs_meeting_body: type: string description: La description de la réunion et de l'événement du calendrier. hs_meeting_end_time: type: string description: "L'heure à laquelle la réunion doit se terminer, au format ISO\_8601." format: date-time hs_meeting_location: type: string description: >- L'adresse physique, l'emplacement virtuel ou le numéro de téléphone où se tiendra la réunion. hs_meeting_location_type: type: string description: "Le type de lieu de la réunion. Les valeurs acceptables sont\_: ADDRESS, CUSTOM, PHONE." enum: - ADDRESS - CUSTOM - PHONE hs_meeting_outcome: type: string description: "Résultat de la réunion. Les valeurs par défaut acceptables sont\_: SCHEDULED, COMPLETED, RESCHEDULED, NO_SHOW, CANCELED. Cette propriété peut être modifiée pour inclure des valeurs personnalisées supplémentaires." hs_meeting_start_time: type: string description: "L'heure à laquelle la réunion doit commencer, au format ISO\_8601." format: date-time hs_meeting_title: type: string description: Le titre de la réunion et de l'événement du calendrier. hs_timestamp: type: string description: >- L'heure à laquelle la réunion doit commencer, au format ISO 8601. Cette valeur doit être identique à `hs_meeting_start_time`. format: date-time hubspot_owner_id: type: string description: >- L'ID du propriétaire de l'utilisateur HubSpot qui accueillera la réunion. 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: >- Type d'activité de la réunion. Les valeurs acceptables sont fondées sur les types d'appels et de réunions définis par le portail. hs_attachment_ids: type: array items: type: string hs_attendee_owner_ids: type: array items: type: string hs_engagement_source: type: string description: La source de l'engagement sera toujours `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: >- L'ID associé au processus a créé l'engagement. Doit toujours être vide lors de la création d'événements de réunion via cette API. hs_include_description_in_reminder: type: string description: Si la description de la réunion doit être incluse dans le rappel. hs_internal_meeting_notes: type: string description: Notes internes relatives à la réunion. hs_meeting_body: type: string description: La description de la réunion et de l'événement du calendrier. hs_meeting_end_time: type: string description: "Heure de fin de la réunion au format ISO\_8601." format: date-time hs_meeting_external_url: type: string description: URL de l'événement du calendrier pour la réunion. hs_meeting_location: type: string description: >- L'adresse physique, l'emplacement virtuel ou le numéro de téléphone où se tiendra la réunion. hs_meeting_location_type: type: string description: "Le type de lieu de la réunion. Les valeurs acceptables sont\_: ADDRESS, CUSTOM, PHONE." enum: - ADDRESS - CUSTOM - PHONE hs_meeting_outcome: type: string description: "Résultat de la réunion. Les valeurs par défaut acceptables sont\_: SCHEDULED, COMPLETED, RESCHEDULED, NO_SHOW, CANCELED. Cette propriété peut être modifiée pour inclure des valeurs personnalisées supplémentaires." hs_meeting_start_time: type: string description: "Heure de début de la réunion au format ISO\_8601." format: date-time hs_meeting_title: type: string description: Le titre de la réunion et de l'événement du calendrier. hs_timestamp: type: string description: >- L'heure à laquelle la réunion doit commencer, au format ISO 8601. Cette valeur doit être identique à `hs_meeting_start_time`. format: date-time hs_unique_id: type: string description: Identifiant unique de l'événement créé dans le calendrier. hubspot_owner_id: type: string description: >- L'identifiant propriétaire de l'utilisateur HubSpot qui héberge la réunion. Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. 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: Identifiant unique d'un objet. description: Contient l'ID d'un objet public AssociationSpec: required: - associationCategory - associationTypeId type: object properties: associationCategory: type: string description: "La catégorie de l'association, par exemple «\_HUBSPOT_DEFINED\_»." enum: - HUBSPOT_DEFINED - INTEGRATOR_DEFINED - USER_DEFINED - WORK associationTypeId: type: integer description: L'ID représentant le type spécifique d'association. format: int32 description: >- Définit le type, la direction et les détails de la relation entre deux objets CRM. ExternalReminder: required: - numberOfTimeUnits - timeUnit type: object properties: numberOfTimeUnits: type: integer description: >- Nombre d'unités de temps avant le début de la réunion auquel le rappel sera envoyé. format: int32 timeUnit: type: string description: "Les valeurs acceptées sont\_: SEMAINES, JOURS, HEURES, MINUTES." enum: - DAYS - HOURS - MINUTES - WEEKS ErrorDetail: required: - message type: object properties: code: type: string description: Le code du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: '{missingScopes=[scope1, scope2]}' in: type: string description: Le nom du champ ou du paramètre dans lequel l'erreur a été trouvée. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. 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.appointments.sensitive.write.v2: '' crm.objects.appointments.write: '' crm.objects.commercepayments.write: '' crm.objects.companies.highly_sensitive.write.v2: '' crm.objects.companies.sensitive.write.v2: '' crm.objects.companies.write: '' crm.objects.contacts.highly_sensitive.write.v2: '' crm.objects.contacts.sensitive.write.v2: '' crm.objects.contacts.write: '' crm.objects.courses.write: '' crm.objects.deals.highly_sensitive.write.v2: '' crm.objects.deals.sensitive.write.v2: '' crm.objects.deals.write: '' crm.objects.goals.write: '' crm.objects.line_items.write: '' crm.objects.listings.write: '' crm.objects.products.write: '' crm.objects.projects.highly_sensitive.write: '' crm.objects.projects.sensitive.write: '' crm.objects.projects.write: '' crm.objects.services.write: '' crm.schemas.meetings.write: '' scheduler.meetings.meeting-link.read: '' tickets.highly_sensitive.v2: '' tickets.sensitive.v2: '' ````