> ## 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éer un nouvel événement de réunion dans le système HubSpot. Ce point de terminaison vous permet de planifier des réunions en fournissant les détails nécessaires tels que le titre de la réunion, les heures de début et de fin, et les informations utilisateur associées. Il est essentiel pour organiser des réunions et gérer les plannings au sein de la plateforme HubSpot.

> **Supported products**

> **Required Scopes**


## OpenAPI

````yaml specs/2027-03-beta/scheduler-meetings-v2027-03-beta.json POST /scheduler/2027-03-beta/meetings/calendar
openapi: 3.0.1
info:
  title: Scheduler Meetings
  description: Meetings Service For HubSpot Sales
  version: 2027-03-beta
  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/2027-03-beta/meetings/calendar:
    post:
      tags:
        - Advanced
      summary: Créer une réunion
      description: >-
        Créer un nouvel événement de réunion dans le système HubSpot. Ce point
        de terminaison vous permet de planifier des réunions en fournissant les
        détails nécessaires tels que le titre de la réunion, les heures de début
        et de fin, et les informations utilisateur associées. Il est essentiel
        pour organiser des réunions et gérer les plannings au sein de la
        plateforme HubSpot.
      operationId: >-
        post-/scheduler/2027-03-beta/meetings/calendar_/scheduler/2026-09-beta/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:
            - 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
          description: >-
            Tableau d’objets d’association pour lier l’événement de réunion à
            d’autres objets HubSpot, tels que des contacts ou des transactions.
          items:
            $ref: '#/components/schemas/ExternalAssociationCreateRequest'
        emailReminderSchedule:
          $ref: '#/components/schemas/ExternalEmailReminderSchedule'
        properties:
          $ref: '#/components/schemas/ExternalCalendarMeetingEventCreateProperties'
        timezone:
          type: string
          description: >-
            Une chaîne représentant le fuseau horaire dans lequel la réunion est
            programmée.
    ExternalCalenderMeetingEventResponse:
      required:
        - createdAt
        - id
        - lastUpdatedAt
        - properties
      type: object
      properties:
        createdAt:
          type: string
          description: "La date et l'heure de création de l'événement de réunion, au format ISO\_8601."
          format: date-time
        id:
          type: string
          description: >-
            L'identifiant unique de l'événement de réunion, représenté sous
            forme de chaîne.
        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
          description: >-
            Un tableau de spécifications d'association qui définissent les types
            d'associations à créer. Chaque élément du tableau est une référence
            à un schéma AssociationSpec.
          items:
            $ref: '#/components/schemas/AssociationSpec'
    ExternalEmailReminderSchedule:
      required:
        - reminders
        - shouldIncludeInviteDescription
      type: object
      properties:
        reminders:
          type: array
          description: "Un tableau d'objets de rappel, chacun spécifiant le moment d'envoi d'un rappel avant la réunion. Chaque rappel inclut le nombre d'unités de temps et le type d'unité de temps\_: semaines, jours, heures, minutes."
          items:
            $ref: '#/components/schemas/ExternalReminder'
        shouldIncludeInviteDescription:
          type: boolean
          description: >-
            Un booléen indiquant si la description de l'invitation à la réunion
            doit être incluse dans les rappels par e-mail.
    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: >-
            Le type d'activité pour la réunion. Il s'agit d'une valeur de
            chaîne.
        hs_attachment_ids:
          type: array
          description: >-
            Un tableau d'ID de pièce jointe associées à la réunion. Chaque ID
            est une chaîne de caractères.
          items:
            type: string
        hs_attendee_owner_ids:
          type: array
          description: >-
            Un tableau d’ID de propriétaires pour les participants à la réunion.
            Chaque ID est une chaîne de caractères.
          items:
            type: string
        hs_internal_meeting_notes:
          type: string
          description: Notes internes pour la réunion. Il s'agit d'une valeur de chaîne.
        hs_meeting_body:
          type: string
          description: >-
            Le contenu ou la description du corps de la réunion. Il s'agit d'une
            valeur de type chaîne.
        hs_meeting_end_time:
          type: string
          description: "L'heure de fin de la réunion, au format de date et d'heure ISO\_8601."
          format: date-time
        hs_meeting_location:
          type: string
          description: L'emplacement de la réunion. Il s'agit d'une valeur de chaîne.
        hs_meeting_location_type:
          type: string
          description: "Le type de lieu pour la réunion. Les valeurs valides incluent «\_TÉLÉPHONE\_», «\_ADRESSE\_» et «\_PERSONNALISÉ\_»."
          enum:
            - ADDRESS
            - CUSTOM
            - PHONE
        hs_meeting_outcome:
          type: string
          description: Le résultat de la réunion. Il s'agit d'une valeur de type chaîne.
        hs_meeting_start_time:
          type: string
          description: >-
            L'heure de début de la réunion, au format de date et d'heure ISO
            8601.
          format: date-time
        hs_meeting_title:
          type: string
          description: Le titre de la réunion. Il s'agit d'une valeur de type chaîne.
        hs_timestamp:
          type: string
          description: >-
            L'horodatage de la création de l'événement de réunion, au format de
            date et d'heure ISO 8601.
          format: date-time
        hubspot_owner_id:
          type: string
          description: >-
            L'identifiant unique du propriétaire HubSpot associé à la réunion.
            Il s'agit d'une valeur de type chaîne de caractères.
    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: Le type d'activité associé à l'événement de réunion.
        hs_attachment_ids:
          type: array
          description: >-
            Un tableau d'identifiants uniques pour les pièces jointes associées
            à l'événement de réunion.
          items:
            type: string
        hs_attendee_owner_ids:
          type: array
          description: >-
            Un tableau d'identifiants uniques pour les propriétaires des
            participants associés à l'événement de réunion.
          items:
            type: string
        hs_engagement_source:
          type: string
          description: "La source de l'engagement pour l'événement de réunion. Les valeurs valides incluent un large éventail de valeurs telles que «\_UNKNOWN\_», «\_IMPORT\_», «\_API\_», «\_FORM\_» et bien d'autres."
          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'identifiant unique de la source de l'engagement.
        hs_include_description_in_reminder:
          type: string
          description: >-
            Indique si la description de la réunion doit être incluse dans les
            rappels.
        hs_internal_meeting_notes:
          type: string
          description: Notes internes relatives à l'événement de réunion.
        hs_meeting_body:
          type: string
          description: Le corps ou la description de l'événement de réunion.
        hs_meeting_end_time:
          type: string
          description: L'heure de fin de l'événement de réunion, au format ISO 8601.
          format: date-time
        hs_meeting_external_url:
          type: string
          description: L'URL externe associée à l'événement de réunion.
        hs_meeting_location:
          type: string
          description: L'emplacement où se déroule l'événement de réunion.
        hs_meeting_location_type:
          type: string
          description: "Le type de lieu pour l'événement de réunion. Les valeurs valides incluent «\_TÉLÉPHONE\_», «\_ADRESSE\_» et «\_PERSONNALISÉ\_»."
          enum:
            - ADDRESS
            - CUSTOM
            - PHONE
        hs_meeting_outcome:
          type: string
          description: Le résultat de l'événement de réunion.
        hs_meeting_start_time:
          type: string
          description: L'heure de début de l'événement de réunion, au format ISO 8601.
          format: date-time
        hs_meeting_title:
          type: string
          description: Le titre de l'événement de réunion.
        hs_timestamp:
          type: string
          description: >-
            Horodatage indiquant la date de création ou de dernière mise à jour
            de l'événement de réunion, au format ISO 8601.
          format: date-time
        hs_unique_id:
          type: string
          description: Un identifiant unique pour l'événement de réunion.
        hubspot_owner_id:
          type: string
          description: >-
            L'identifiant unique de l'ID du propriétaire HubSpot associé à
            l'événement de 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: >-
            L'identifiant unique de l'objet public, représenté sous forme de
            chaîne de caractères.
      description: Contains the Id of a Public Object
    AssociationSpec:
      required:
        - associationCategory
        - associationTypeId
      type: object
      properties:
        associationCategory:
          type: string
          description: "Chaîne de caractères représentant la catégorie de l'association. Les valeurs valides incluent «\_HUBSPOT_DEFINED\_», «\_USER_DEFINED\_», «\_INTEGRATOR_DEFINED\_» et «\_WORK\_»."
          enum:
            - HUBSPOT_DEFINED
            - INTEGRATOR_DEFINED
            - USER_DEFINED
            - WORK
        associationTypeId:
          type: integer
          description: Un entier représentant l'identifiant unique du type d'association.
          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: >-
            Le nombre d'unités de temps avant la réunion auquel le rappel doit
            être envoyé. Il s'agit d'une valeur entière.
          format: int32
        timeUnit:
          type: string
          description: "L'unité de temps utilisée pour le rappel. Les valeurs valides incluent «\_SEMAINES\_», «\_JOURS\_», «\_HEURES\_» et «\_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é détectée.
            Il s'agit d'une propriété de type chaîne de caractères.
        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: ''

````