> ## 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. # Send an event occurrence > Envoyez des données pour une occurrence unique d'événement personnalisé. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-03/events-send-event-completions-v2026-03.json POST /events/2026-03/send openapi: 3.0.1 info: title: Events Send Event Completions description: Basepom for all HubSpot Projects version: 2026-03 x-hubspot-product-tier-requirements: marketing: ENTERPRISE sales: ENTERPRISE service: ENTERPRISE cms: ENTERPRISE commerce: ENTERPRISE crmHub: ENTERPRISE dataHub: ENTERPRISE servers: - url: https://api.hubapi.com security: [] tags: - name: Basic - name: Batch paths: /events/2026-03/send: post: tags: - Basic summary: Envoyer une occurrence d'événement personnalisé description: Envoyez des données pour une occurrence unique d'événement personnalisé. operationId: post-/events/2026-03/send_send parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/BehavioralEventHttpCompletionRequest' required: true responses: '204': description: No content content: {} default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - analytics.behavioral_events.send components: schemas: BehavioralEventHttpCompletionRequest: required: - eventName - properties type: object properties: email: type: string description: >- L'adresse e-mail du visiteur. Utilisée pour associer les données de l'événement à une fiche d'informations CRM. eventName: type: string description: "Le nom qualifié complet de l'événement. Cette valeur (au format «\_{HubID}_{name}\_») peut être récupérée via [l'API de définition des événements] (https://developers.hubspot.com/docs/reference/api/analytics-and-events/custom-events/custom-event-definitions#get-%2Fevents%2Fv3%2Fevent-definitions) ou dans [l'interface utilisateur de HubSpot] (https://knowledge.hubspot.com/reports/create-custom-behavioral-events-with-the-code-wizard#find-internal-name). " objectId: type: string description: >- L'ID de la fiche d'informations concernée par l'événement (par exemple, l'ID du contact ou l'ID du visiteur). occurredAt: type: string description: >- Le moment où cet événement s'est produit. S'il n'est pas défini, l'heure actuelle sera utilisée. format: date-time properties: type: object additionalProperties: type: string description: >- Les propriétés de l'événement à mettre à jour. Suit le format des paires clé-valeur (nom interne de la propriété et valeur de la propriété). En savoir plus sur [les propriétés d'événement par défaut de HubSpot] (https://developers.hubspot.com/docs/guides/api/analytics-and-events/custom-events/custom-event-definitions#hubspot-s-default-event-properties). utk: type: string description: >- Le 'usertoken' du visiteur. Utilisé pour associer les données de l'événement à une fiche d'informations CRM. uuid: type: string description: >- Un identifiant unique pour l'occurrence de l'événement. Doit être unique au sein du type d'événement. S'il n'est pas fourni, HubSpot générera un UUID aléatoire. Lorsque plusieurs événements ont le même identifiant au cours d'une année, le premier sera accepté et tous les autres seront rejetés. Peut être utile pour faire correspondre les données entre HubSpot et d'autres systèmes externes. 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 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: analytics.behavioral_events.send: '' behavioral_events.event_definitions.read_write: '' ````