thanks.io icon

thanks.io

Interact with thanks.io API

Actions7

Mailer → Send Windowless Letter

AI-generated

Summary

Send a windowless letter mailer to specified recipients via the thanks.io API, using either existing mailing lists, direct recipient data, or a radius-based search to define the audience.

Inputs

  • Authentication (required) — Choose authentication method; currently supports Personal Access Tokens (API Key).
  • Audience (required) — Select how to specify recipients: mailing lists, direct recipients, or radius search near an address.
  • Mailing Lists (required) — If sending to mailing lists, provide one or more mailing list IDs to target.
  • Recipients (required) — If sending to direct recipients, provide one or more recipient details including name, address, and optional contact and custom fields.
  • Radius Search (required) — If selecting radius search, specify a full street address and additional optional search parameters to buy a targeted mailing list near that address.
  • Image Template ID — ID of an image template for the letter background; required if no Front Image URL is provided.
  • Front Image URL — URL of the image to use as the letter background; required if no Image Template ID is specified.
  • Message — Handwritten message content using placeholders for personalization.
  • Message Template ID — ID of a predefined message template to use instead of a manual message.
  • QR Code URL — URL to generate a QR code on the letter; uses account default if not specified.
  • Additional Pages URL — URL to additional pages to include with the cover letter.
  • PDF Only URL — URL to a PDF file for the entire mailer; if provided, no cover letter is generated.
  • Additional Fields — Optional additional settings including handwriting color, style, notification emails, return address, postage type, sub-account, and preview mode.

Output shape

a single JSON response from the thanks.io API describing the order result or preview data

The API response includes status and details of the mailer order. If preview mode is enabled, the response includes a preview and estimated costs instead of placing the order.

Links

Discussion