This feature can be leveraged to create a unique postcard at the time it is needed. It's ideal for Agencies who may need a way to generate unique postcards for their Agents as needed without having to design a card before an order is placed.

Specifically, you can use the generator url to power a Zapier integration to generate cards for automatic sending as needed. For example, if you wanted to send someone a postcard that automatically has their street address printed on the front.

Each card is composed of different layers. The background sits at the bottom, the "Overlay" sits above that, and finally the header text, QR code, and Logo are all on the same layer at the top.

URL Structure:



https://api.thanks.io/api/v2/build/image-template?id=&background_url=&header=&subheader=&redirect_url=&logo_url=&overlay_url=

  • id - This is the design ID that dictates where the placement of the elements will be such as the QR Code and heading text.

  • background_url - The background image for the postcard that sits beneath all of the other layers.

  • header - Large text on the card.

  • subheader - Small text on the card.

  • redirect_url - QR Code URL.

  • logo_url - URL to your company logo.

  • overlay_url - If you want to use a different overlay than what is associated with the ID number, you can specify a transparent overlay to sit on top of the background instead.

Dynamic Card Builder Interface


If you want to use a visual interface to construct the URL (instead of typing it out by hand) you need to generate your dynamic card, we've built one here.

Available Layout Samples (Default Overlays)


In the below examples, we'll be using our thanks.io logo and this background image (1875x1275px):

Example URL


This is the URL that generates the card sample below for Layout id=1:

https://api.thanks.io/api/v2/build/image-template?id=1&background_url=https://s3.amazonaws.com/cdn.thanks.io/user_image_library/XHiy9Tk0XzZiQc1rl4xhofcePabEXwKed1vsWObB.png&header=HEADER%20TEXT&subheader=SUBHEADER%20TEXT&redirect_url=https://www.thanks.io&logo_url=https://thanks.io/assets/brand/logo@2x.png&overlay_url

Card Samples Using The Example URL Above For Each Layout:

Layout id=1

Layout id=2

Layout id=3

Layout id=4

Layout id=5

Layout id=6

Layout id=7

Layout id=8

How To Generate Custom Postcards "On The Fly" In Zapier


When configuring your Zap, in the send card action simply supply the builder URL with the parameters filled in, into the Image URL Field:

If we knew what would go into the URL ahead of time, it would be pretty easy. But what we want to do is dynamically generate unique designs for each card we send out.

In this example, we'll generate designs from a Google Sheet to best illustrate what is possible.

However, this concept applies to ANYTHING you can connect via Zapier. As long as the information is there.

For example, if I connect my Real Estate CRM software to a zap, I can pull a homeowner's address into the field I want to print on the card. Or, even an image of their home, if one is available.

This example above produces this design with the homeowner's address (123 Fake Street) in the sub-header:

To show you what it would look like if we set all of the parameters in our zap, I've created a google sheet that houses all of the parameters in one place for the sake of simplicity.

Note - in this google sheet example, I will also set a custom overlay. To give you an idea of what's possible, I set the company logo on my overlay and will not specify a company logo URL in my URL. This shows you just how powerful this image generator is:

URL:

https://api.thanks.io/api/v2/build/image-template?id=&background_url=&header=&subheader=&redirect_url=&logo_url=&overlay_url=

URL Parameters:

  • id - This is the design ID that dictates where the placement of the elements will be such as the QR Code and heading text.

  • background_url - The background image for the postcard that sits beneath all of the other layers.

  • header - Large text on the card.

  • subheader - Small text on the card.

  • redirect_url - QR Code URL.

  • logo_url - URL to your company logo.

  • overlay_url - If you want to use a different overlay than what is associated with the ID number, you can specify a transparent overlay to sit on top of the background instead.

With all of the data above set in my sheet, I can insert all of the variables into the URL:

The design generated dynamically based off of info in a spreadsheet looks like this:

I might tweak my overlay a little bit more before sending, but you get the idea! By going off of just text data from another system or even a spreadsheet, I can generate postcards for any purpose without actually needing to design them one at a time!

Notes:


  • The image template field is only used when choosing a design from your image templates in thanks.io

  • The 'Custom Background Image' is used for the address-side of the postcard, not the design-side.

Did this answer your question?