# 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 Settings API
  version: 1.0.0
extends: openapi/hubspot-settings-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/{appId}/settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's marketing event settings
      effect: read
      questions:
      - What event details URL is my marketing events app configured with?
      - Where can I see the current settings of my marketing events integration?
      instructions:
      - text: Show the marketing event settings for app {appId}.
        slots:
          appId: path.appId
      - text: Get the configured event details URL of app {appId}.
        slots:
          appId: path.appId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/marketing/marketing-events/2026-09/{appId}/settings'].post
  update:
    x-apievangelist-phrasing:
      intent: Set an app's marketing event settings
      effect: write
      questions:
      - How do I tell HubSpot where to fetch marketing event details from my app?
      - Can I change the event details URL my app registered earlier?
      instructions:
      - text: Set the event details URL for app {appId} to {eventDetailsUrl}.
        slots:
          appId: path.appId
          eventDetailsUrl: requestBody.eventDetailsUrl
      - text: Update app {appId} settings so event details load from {eventDetailsUrl}.
        slots:
          appId: path.appId
          eventDetailsUrl: requestBody.eventDetailsUrl
      method: generated
      generated: '2026-09-24'