# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Marketing Marketing Events Subscriber State Changes API
  version: 1.0.0
extends: openapi/hubspot-subscriber-state-changes-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/marketing/marketing-events/2026-09/events/{externalEventId}/{subscriberState}/email-upsert'].post
  update:
    x-apievangelist-phrasing:
      intent: Record event attendance state by contact email
      effect: write
      questions:
      - How do I mark a list of contacts as registered or attended for a marketing event using their email addresses?
      - Will recording a subscriber state by email create the contact if it doesn't exist?
      instructions:
      - text: Set contacts {inputs} to {subscriberState} for event {externalEventId} in account {externalAccountId}, matching by email.
        slots:
          inputs: requestBody.inputs
          subscriberState: path.subscriberState
          externalEventId: path.externalEventId
          externalAccountId: query.externalAccountId
      - text: 'Using email addresses, record {subscriberState} for these attendees of event {externalEventId} (account {externalAccountId}): {inputs}.'
        slots:
          subscriberState: path.subscriberState
          externalEventId: path.externalEventId
          externalAccountId: query.externalAccountId
          inputs: requestBody.inputs
      method: generated
      generated: '2026-09-24'
- target: $.paths['/marketing/marketing-events/2026-09/events/{externalEventId}/{subscriberState}/upsert'].post
  update:
    x-apievangelist-phrasing:
      intent: Record event attendance state by contact ID
      effect: write
      questions:
      - Can I record that contacts cancelled or attended an event when I only have their HubSpot contact IDs?
      - Does the ID-based subscriber state update require the contacts to already exist?
      instructions:
      - text: Set contact IDs {inputs} to {subscriberState} for event {externalEventId} in account {externalAccountId}.
        slots:
          inputs: requestBody.inputs
          subscriberState: path.subscriberState
          externalEventId: path.externalEventId
          externalAccountId: query.externalAccountId
      - text: By contact ID, mark {inputs} as {subscriberState} on marketing event {externalEventId} for account {externalAccountId}.
        slots:
          inputs: requestBody.inputs
          subscriberState: path.subscriberState
          externalEventId: path.externalEventId
          externalAccountId: query.externalAccountId
      method: generated
      generated: '2026-09-24'