Thanks.io

The Thanks.io modules allow you to add, update, list. and delete the recipients and send postcards from your Thanks.io account.

Getting Started with Thanks.io

Prerequisites

  • A Thanks.io account

In order to use Thanks.io with Integromat, it is necessary to have a Thanks.io account. If you do not have one, you can create a Thanks.io account at thanks.io.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Thanks.io to Integromat

To connect your Thanks.io account to Integromat you need to obtain the API Key from your Thanks.io account and insert it in the Create a connection dialog in the Integromat module.

1. Log in to your Thanks.io account.

2. Click Settings (msedge_Lrm4kbFz3r.png) > API Access

3. In the Personal Access Token field, click + icon, enter a name for the token and click Create.

4. Copy the API Token to your clipboard.

W5OXaEHKh3.gif

5. Go to Integromat and open the Thanks.io module's Create a connection dialog.

6OfyC18Lia.gif

6. In the Connection name field, enter a name for the connection.

7. In the API Key field, enter the token copied in step 4, and click Continue.

The connection has been established.

Send Letter/Postcard

Send a Letter

Sends a letter.

ConnectionEstablish a connection to your Thanks.io account.
Front Image URLEnter the letter's front image URL address.
Handwriting StyleSelect or map the handwriting style for the letter.
MessageEnter the message text to add to the letter.
Mailing ListsAdd the mailing lists to which you want to send the letter.
Return NameEnter the contact's name to return the letter if undelivered.
Return AddressEnter the street address to which the letter should be returned.
Return Address 2Enter the street address to which the letter should be returned.
Return CityEnter the city name to which the letter should be returned.
Return StateEnter the state name to which the letter should be returned.
Return Postal CodeEnter the area postal code to which the letter should be returned.

Send a 4x6 Postcard

Sends a 4x6 postcard.

ConnectionEstablish a connection to your Thanks.io account.
Image TemplateSelect or map the image template to use for the postcard.
Handwriting StyleSelect or map the handwriting style to apply the postcard.
MessageEnter the message text to add to the postcard.
Recipients

Add the recipients of the postcard:

AddressEnter the recipient's street name.
CityEnter the recipient's city name.
ProvinceEnter the recipient's state or province name.
Postal CodeEnter the recipient's area postal code.
CountryEnter teh recipient's country name.
NameEnter the recipient's name.
Use Custom BackgroundSelect whether to apply the custom background to the postcard.
Custom Background Image URLEnter the background image URL address to apply to the postcard.

Send a 6x9 Postcard

Sends a 6x9 postcard.

ConnectionEstablish a connection to your Thanks.io account.
Image TemplateSelect or map the image template to use for the postcard.
Handwriting StyleSelect or map the handwriting style to apply the postcard.
Message TemplateSelect or map the message template to apply to the postcard.
AddressEnter (map) the complete address to which you want to send the postcard. For example, 1 Main St, Warwick, NY 10990
Radius Distance MilesEnter (map) the distance in miles.

Recipients

List Recipients

Lists all recipients in the selected mailing list.

ConnectionEstablish a connection to your Thanks.io account.
Mailing List IDSelect or map the mailing list whose recipients you want to list. 
Updated SinceEnter the date to list the recipient's updated on or after the specified date. See the list of supported date and time formats.
LimitSet the maximum number of recipients Integromat should return during one execution cycle.

Get a Recipient

Returns details about the selected recipient.

ConnectionEstablish a connection to your Thanks.io account.
Mailing List IDSelect or map the mailing list whose recipients you want to list.
Recipient IDSelect or map the Recipient ID whose details you want to retrieve.

Add a Recipient

Adds a recipient to a mailing list.

ConnectionEstablish a connection to your Thanks.io account.
Mailing List IDSelect or map the mailing list to which you want to add the recipient.
Street AddressEnter the recipient's street name. For example, 7777 Main st.
Address 2Enter the recipient's street name. For example, 7777 Main st.
Recipient NameEnter the recipient's name.
CityEnter the recipient's city name.
ProvinceEnter the recipient's state or province name.
Postal CodeEnter the recipient's area postal code.
CountryEnter the recipient's country name.
Date of BirthEnter the recipient's date of birth.
Custom 1(Optional) Enter the custom field name and values for the recipient.
Custom 2(Optional) Enter the custom field name and values for the recipient.

Update a Recipient

Updates an existing recipient from the selected mailing list.

ConnectionEstablish a connection to your Thanks.io account.
Recipient IDSelect or map the Recipient ID whose details you want to update.
Mailing List IDSelect or map the mailing list to which you want to add the recipient.
Street AddressEnter the recipient's street name. For example, 7777 Main st.
Address 2Enter the recipient's street name. For example, 7777 Main st.
Recipient NameEnter the recipient's name.
CityEnter the recipient's city name.
ProvinceEnter the recipient's state or province name.
Postal CodeEnter the recipient's area postal code.
CountryEnter the recipient's country name.
Date of BirthEnter the recipient's date of birth.
Custom 1(Optional) Enter the custom field name and values for the recipient.
Custom 2(Optional) Enter the custom field name and values for the recipient.

Delete a Recipient

Deletes an existing recipient from the selected mailing list.

ConnectionEstablish a connection to your Thanks.io account.
Mailing List IDSelect or map the mailing list to which you want to add the recipient.
Recipient IDSelect or map the Recipient ID whose details you want to delete.

Other

Make an API Call

Performs an arbitrary authorized API call.

ConnectionEstablish a connection to your Thanks.io account.
URL

Enter a path relative to https://api.thanks.io/api/. For example: /v2/ping

For the list of available endpoints, refer to the Thanks.io API Documentation.
Method

Select the HTTP method you want to use:

GET
to retrieve information for an entry.

POST
to create a new entry.

PUT
to update/replace an existing entry.

PATCH
to make a partial entry update.

DELETE
to delete an entry.

HeadersEnter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query StringEnter the request query string.
BodyEnter the body content for your API call.

Example of Use - Get Mailing Lists

The following API call returns all the mailing lists from your Thanks.io account:

URL:
/v2/mailing-lists

Method:
GET

thanksio2.png

Matches of the search can be found in the module's Output under BundleBody > data
In our example, 2 tasks were returned:

tanksio1.png

Get Order Details

Returns order details by ID.

ConnectionEstablish a connection to your Thanks.io account.
Order IDSelect or map the Order ID whose details you want to retrieve.

Popular use cases from our blog

trello2

How to Automatically Turn Tweets Into Inspiring Images [Tutorial]

part4

How to Automate Procurement in Your Shopify Store - Part 4

part3

How to Automate Procurement in Your Shopify Store - Part 3

shopify

How to Automate Procurement in Your Shopify Store - Part 2

crm

8 Powerful and Free CRM Integrations to Boost Your Work

procur

How to Automate Procurement in Your Shopify Store - Part 1

Didn’t find what you were looking for?

Ticket

Create a ticket

Contact our world-class support team and tell us what’s happening.

Create a ticket
Expert

Find an expert

We feature a network of 450+ certified partners across the globe who are ready to help

Find an expert

Automate any workflow in your business

Sign up for a free account today. No credit card required, no time limits on free plan.