# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Transactional Single Send SMTP Tokens API
  version: 1.0.0
extends: openapi/hubspot-smtp-tokens-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: 5
- target: $.paths['/marketing/transactional/2026-09/smtp-tokens'].get
  update:
    x-apievangelist-phrasing:
      intent: Find SMTP API tokens by campaign
      effect: read
      questions:
      - How do I find which SMTP API tokens exist for a given email campaign name?
      - Can I look up an SMTP token using its email campaign ID?
      instructions:
      - text: List the SMTP API tokens for campaign {campaignName}.
        slots:
          campaignName: query.campaignName
      - text: Find the SMTP token tied to email campaign ID {emailCampaignId}.
        slots:
          emailCampaignId: query.emailCampaignId
      - text: Show all my SMTP API tokens.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/marketing/transactional/2026-09/smtp-tokens'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an SMTP API token
      effect: write
      questions:
      - How do I get credentials to send transactional email through HubSpot's SMTP API?
      - Can I have contacts created automatically for people I email via SMTP?
      instructions:
      - text: Create an SMTP API token for campaign {campaignName}.
        slots:
          campaignName: requestBody.campaignName
      - text: Generate an SMTP token named {campaignName} and set contact creation to {createContact}.
        slots:
          campaignName: requestBody.campaignName
          createContact: requestBody.createContact
      method: generated
      generated: '2026-09-24'
- target: $.paths['/marketing/transactional/2026-09/smtp-tokens/{tokenId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one SMTP API token
      effect: read
      questions:
      - Can I see the details of one SMTP token if I know its token ID?
      - What campaign is a particular SMTP token linked to?
      instructions:
      - text: Get SMTP token {tokenId}.
        slots:
          tokenId: path.tokenId
      - text: Show me the details for SMTP API token ID {tokenId}.
        slots:
          tokenId: path.tokenId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/marketing/transactional/2026-09/smtp-tokens/{tokenId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an SMTP API token
      effect: destructive
      questions:
      - Is there a way to delete an SMTP token I'm no longer using?
      - Can I get rid of a leaked SMTP token entirely?
      instructions:
      - text: Delete SMTP token {tokenId}.
        slots:
          tokenId: path.tokenId
      - text: Permanently remove the SMTP API token with ID {tokenId}.
        slots:
          tokenId: path.tokenId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/marketing/transactional/2026-09/smtp-tokens/{tokenId}/password-reset'].post
  update:
    x-apievangelist-phrasing:
      intent: Rotate the password of an SMTP token
      effect: destructive
      questions:
      - How do I rotate the password on an SMTP token while keeping the token itself?
      - Does resetting an SMTP token password immediately invalidate the old one?
      instructions:
      - text: Reset the password for SMTP token {tokenId}.
        slots:
          tokenId: path.tokenId
      - text: Issue a new password for token {tokenId} and invalidate the old one.
        slots:
          tokenId: path.tokenId
      method: generated
      generated: '2026-09-24'