thanks.io icon

thanks.io

Interact with thanks.io API

Actions7

Mailer → Send Notecard

AI-generated

Summary

Send a folded notecard mailer through the thanks.io API with customizable recipient specification and mailer content.

Inputs

  • Authentication (required) — Select the authentication method; currently only Personal Access Tokens (API Key) are supported.
  • Audience (required) — Specify how recipients are provided: existing mailing lists, directly specified recipients, or a radius search near an address.
  • Mailing Lists — If Audience is Mailing Lists, provide one or more existing mailing list IDs to send the notecard to.
  • Recipients — If Audience is Recipients, provide one or more recipient details including name, company, full address, email, phone, date of birth, and custom fields.
  • Radius Search — If Audience is Radius Search, specify parameters for a nearest-neighbor buying list near an address, including address, number of records, record types, and preview option.
  • Image Template ID — ID of the image template to use for the front of the notecard; required if Front Image URL is not provided. Use 0 to omit.
  • Front Image URL — URL of the image for the front of the notecard; required if Image Template ID is not specified.
  • Message — Custom handwritten message content that can use placeholders like %FIRST_NAME% for personalization.
  • Message Template ID — ID of a predefined message template to use instead of a custom message. Use 0 to omit.
  • QR Code URL — URL to generate a QR code on the notecard. Defaults to the account's QR code if not specified.
  • Use Custom Background — Enable to use a custom background image instead of the default background.
  • Custom Background Image URL — URL to a custom background image placed behind the handwritten message.
  • Additional Fields — Further customization options such as handwriting color, handwriting realism, handwriting style ID, notification emails, preview mode, return address details, postage type, and sub-account ID.

Output shape

a list of JSON objects containing the API response for each sent notecard or preview request, paired with the input item index

Returns the JSON response from the thanks.io API for each input item. When 'Preview' is enabled, returns a preview of the mail piece instead of sending it. Errors per item are returned when 'Continue On Fail' is enabled.

Links

Discussion