# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for AhaSend API v2 Webhooks API
  version: 1.0.0
extends: openapi/ahasend-webhooks-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/v2/accounts/{account_id}/webhooks'].get
  update:
    x-apievangelist-phrasing:
      intent: List event webhooks
      effect: read
      questions:
      - Which event notification webhooks are configured on my account?
      - Can I list only webhooks that fire on bounces?
      instructions:
      - text: List all webhooks on account {account_id}.
        slots:
          account_id: path.account_id
      - text: Show webhooks on account {account_id} where enabled is {enabled}.
        slots:
          account_id: path.account_id
          enabled: query.enabled
      - text: Find webhooks on account {account_id} with the bounce trigger set to {on_bounced}.
        slots:
          account_id: path.account_id
          on_bounced: query.on_bounced
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/accounts/{account_id}/webhooks'].post
  update:
    x-apievangelist-phrasing:
      intent: Subscribe a URL to email events
      effect: write
      questions:
      - How do I get notified at my URL when an email is delivered or bounces?
      - Can I create a webhook that only covers some of my domains?
      - Which email events can trigger a webhook, like opens and clicks?
      instructions:
      - text: Create a {scope} webhook named {name} posting to {url} on account {account_id}.
        slots:
          scope: requestBody.scope
          name: requestBody.name
          url: requestBody.url
          account_id: path.account_id
      - text: Add webhook {name} at {url} with scope {scope} for domains {domains}, firing on bounces, on account {account_id}.
        slots:
          name: requestBody.name
          url: requestBody.url
          scope: requestBody.scope
          domains: requestBody.domains
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/accounts/{account_id}/webhooks/{webhook_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: View one webhook
      effect: read
      questions:
      - Which events is a specific webhook subscribed to?
      - Where does one particular webhook deliver its notifications?
      instructions:
      - text: Show webhook {webhook_id} on account {account_id}.
        slots:
          webhook_id: path.webhook_id
          account_id: path.account_id
      - text: Get the URL and event triggers of webhook {webhook_id} in account {account_id}.
        slots:
          webhook_id: path.webhook_id
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/accounts/{account_id}/webhooks/{webhook_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change an existing webhook
      effect: write
      questions:
      - How do I add click events to a webhook I already set up?
      - Can I move an existing webhook to a new URL without recreating it?
      instructions:
      - text: Change the URL of webhook {webhook_id} to {url} on account {account_id}.
        slots:
          webhook_id: path.webhook_id
          url: requestBody.url
          account_id: path.account_id
      - text: Set on_clicked to {on_clicked} for existing webhook {webhook_id} in account {account_id}.
        slots:
          on_clicked: requestBody.on_clicked
          webhook_id: path.webhook_id
          account_id: path.account_id
      - text: Disable webhook {webhook_id} on account {account_id} by setting enabled to {enabled}.
        slots:
          webhook_id: path.webhook_id
          account_id: path.account_id
          enabled: requestBody.enabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/accounts/{account_id}/webhooks/{webhook_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a webhook
      effect: destructive
      questions:
      - How do I stop sending email event notifications to an old endpoint?
      - Can I permanently remove a webhook?
      instructions:
      - text: Delete webhook {webhook_id} from account {account_id}.
        slots:
          webhook_id: path.webhook_id
          account_id: path.account_id
      - text: Remove event webhook {webhook_id} in account {account_id}.
        slots:
          webhook_id: path.webhook_id
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'