thanks.io icon

thanks.io

Interact with thanks.io API

Actions7

Mailer → Send Postcard

AI-generated

Summary

Send a physical postcard mailer through the thanks.io service to a specified audience, which can be defined as existing mailing lists, individual recipients, or a radius-based address search.

Inputs

  • Authentication (required) — Choose Personal Access Tokens (API Key) for authentication.
  • Audience Type (required) — Specify recipients by selecting one of mailing lists, direct recipients, or radius search near an address.
  • Mailing List IDs — Provide one or more mailing list IDs to send to existing mailing lists (required if audience type is 'mailingLists').
  • Recipients — Supply one or more recipients' details directly including name, company, address lines, city, state/province, postal code, country, email, phone, DOB, and optional custom fields (required if audience type is 'recipients').
  • Radius Search — Configure radius search parameters including center address, number of records, record types, options to append email/phone data, include condos, include the search address in the list, preview selections, and whether to use property owner's address (required if audience type is 'radiusSearch').
  • Image Template ID — ID of the image template for the front of the postcard; required if Front Image URL is not specified, use 0 to omit.
  • Front Image URL — URL to an image to use for the front of the postcard; required if Image Template ID is not specified.
  • Message — Handwritten message content supporting placeholders (e.g., %FIRST_NAME%) for personalization.
  • Message Template ID — ID of a predefined message template to use, or 0 to omit.
  • Size — Postcard size option: 4x6 (default), 6x9, or 6x11.
  • QR Code URL — URL to generate a QR code on the postcard; defaults to account's QR code URL if unspecified.
  • Use Custom Background — Enable to use a custom background image, disabling default background.
  • Custom Background Image URL — URL to a custom background image placed behind the handwritten message.
  • Additional Fields — Optional additional configuration including handwriting color, realism effect, handwriting style ID, notification emails, preview mode, return address fields, postage type, and sub-account ID.

Output shape

a list of response objects for each input item, each containing the API response JSON

If preview mode is enabled, the API returns a preview instead of placing an order. Errors per item are handled according to the node's continue-on-fail setting.

Links

Discussion