> ## 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. # Record attendance by participant email and external event ID > Enregistre la participation de plusieurs contacts HubSpot à un événement marketing en utilisant leurs adresses e-mail. Si un contact n'existe pas, il sera automatiquement créé. Le champ contactProperties est utilisé exclusivement pour créer de nouveaux contacts et ne mettra pas à jour les propriétés des contacts existants. Fonctionnalité supplémentaire : - Ajoute un événement de la chronologie aux contacts. Propriétés autorisées : Pour l'état « participer » : - joinedAt - leftAt > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-03/marketing-marketing-events-v2026-03.json POST /marketing/marketing-events/2026-03/attendance/{externalEventId}/{subscriberState}/email-create openapi: 3.0.1 info: title: Marketing Marketing Events description: Basepom for all HubSpot Projects 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: Basic - name: Batch - name: Event Attendees - name: Event Status - name: Identifiers - name: List Associations - name: Participant State - name: Settings - name: Subscriber State Changes paths: /marketing/marketing-events/2026-03/attendance/{externalEventId}/{subscriberState}/email-create: post: tags: - Event Attendees summary: >- Enregistrer des participants par e-mail avec les ID externes de l'événement marketing description: "Enregistre la participation de plusieurs contacts HubSpot à un événement marketing en utilisant leurs adresses e-mail.\n\nSi un contact n'existe pas, il sera automatiquement créé. Le champ contactProperties est utilisé exclusivement pour créer de nouveaux contacts et ne mettra pas à jour les propriétés des contacts existants.\n\nFonctionnalité supplémentaire\_:\n- Ajoute un événement de la chronologie aux contacts.\n\nPropriétés autorisées\_:\nPour l'état «\_participer\_»\_:\n- joinedAt\n- leftAt" operationId: >- post-/marketing/marketing-events/2026-03/attendance/{externalEventId}/{subscriberState}/email-create_recordByContactEmails parameters: - name: externalEventId in: path description: >- L'ID de l'événement marketing dans l'application d'événements externe. required: true style: simple explode: false schema: type: string - name: subscriberState in: path description: >- L'état de l'abonnement, qui peut être utilisé pour indiquer le statut de présence. required: true style: simple explode: false schema: type: string - name: externalAccountId in: query description: >- L'identifiant de compte associé à l'événement marketing dans l'application d'événement externe. required: false style: form explode: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/BatchInputMarketingEventEmailSubscriber' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/BatchResponseSubscriberEmailResponse' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.objects.marketing_events.write components: schemas: BatchInputMarketingEventEmailSubscriber: required: - inputs type: object properties: inputs: type: array description: Liste des détails de l'événement marketing à créer ou mettre à jour items: $ref: '#/components/schemas/MarketingEventEmailSubscriber' BatchResponseSubscriberEmailResponse: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- Horodatage indiquant quand le traitement de la requête s'est terminé. format: date-time errors: type: array description: >- Un tableau d'erreurs rencontrées pendant l'opération par lots, chacune fournissant des détails sur l'erreur. items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: Résultat de la demande numErrors: type: integer description: Le nombre d'erreurs survenues pendant le traitement format: int32 requestedAt: type: string description: Horodatage indiquant le moment où la demande a été effectuée format: date-time results: type: array description: >- Un tableau de résultats de l'opération par lots, chacun contenant des détails sur la réponse d'un e-mail d'abonné. items: $ref: '#/components/schemas/SubscriberEmailResponse' startedAt: type: string description: Horodatage indiquant quand le traitement de la requête a commencé. format: date-time status: type: string description: Statut du traitement de la demande enum: - CANCELED - COMPLETE - PENDING - PROCESSING MarketingEventEmailSubscriber: required: - contactProperties - email - interactionDateTime - properties type: object properties: contactProperties: type: object additionalProperties: type: string description: L'ensemble clé-valeur contenant les propriétés du contact. email: type: string description: L'adresse e-mail du contact dans HubSpot à associer à l'événement. interactionDateTime: type: integer description: >- Horodatage en millisecondes auquel le contact s'est inscrit à l'événement. format: int64 properties: type: object additionalProperties: type: string description: >- L'ensemble clé-valeur contenant les propriétés de l'événement marketing. StandardError: required: - category - context - errors - links - message - status type: object properties: category: type: string description: La catégorie de l'erreur context: type: object additionalProperties: type: array items: type: string description: L'objet qui contient les détails des erreurs errors: type: array description: >- Un tableau d'objets ErrorDetail fournissant des informations supplémentaires sur l'erreur. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: L'ID de la demande links: type: object additionalProperties: type: string description: Résultats de la demande message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant status: type: string description: Statut de la réponse subCategory: type: object properties: {} description: La sous-catégorie de l'erreur description: Ye olde error SubscriberEmailResponse: required: - email - vid type: object properties: email: type: string description: L'adresse e-mail du contact vid: type: integer description: L'ID interne du contact format: int64 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: crm.objects.marketing_events.read: '' crm.objects.marketing_events.write: '' ````