# Thanks.io

## Connection <a href="#connect" id="connect"></a>

When you're setting up your first workflow with thanks.io, you'll need to add your private API key so that thanks.io is a connected app within MESA.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FuVRnCdvKn4QA6WfIa2jj%2Fimage.png?alt=media&#x26;token=ee557555-3c6c-4414-8582-85fb59496f72" alt=""><figcaption></figcaption></figure>

You can create your private API key by clicking Settings (gear icon) > API Access on the thanks.io Dashboard. This link will also take you to where you will find the API key: [dashboard.thanks.io/profile/billing](https://dashboard.thanks.io/profile/billing)

Click on the plus icon on the right hand side, under Personal Access Tokens.

Enter your preferred name of the API Key and click on Create.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FJ07C2e5KhpuDkkfBhrjO%2FEF-thanks-io-API.png%20-%20Step%202.png?alt=media&#x26;token=7a9e8a46-490b-45fc-860c-fff4b9083095" alt=""><figcaption></figcaption></figure>

Afterwards, you will be shown your first Personal Access Token. This will be the only time you will be shown the token so make sure to copy everything in the text box. Paste that into your MESA workflow's thanks.io [Connection](https://docs.getmesa.com/going-further/credentials) section. Click on Add Connection and then you are all set!

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2F6X8Ukhmbyvn3kvkGVfBH%2FEF-thanks-io-API_png_-_Step_3__1_.png?alt=media&#x26;token=57754d0f-a9f4-4ebd-b304-91a75cf47545" alt=""><figcaption></figcaption></figure>

## Technical Notes <a href="#configuring" id="configuring"></a>

### Front Image URL <a href="#front-image-url" id="front-image-url"></a>

For the Front Image URL field, you will need to copy and paste the image's URL. This field is required for all Send [actions](https://docs.getmesa.com/workflow-builder/triggers).

### Send Letters, Notecards, and Postcards Actions <a href="#send" id="send"></a>

In the Letter Send, Notecard Send, and Postcard Send [actions](https://docs.getmesa.com/workflow-builder/triggers), you will need to fill out all the configuration fields listed with a \* within the action. If one of the fields is missing a value, your automations will fail.

### Return Configuration Fields <a href="#return" id="return"></a>

In the Letter Send, Notecard Send, and Postcard Send [actions](https://docs.getmesa.com/workflow-builder/triggers), there will be some configuration fields set for a Return address.

You can copy and paste the following [variables](https://docs.getmesa.com/workflow-builder/fields/variables) if you'd like to set your store's Store address as the Return address for the letters, notecards, or postcards. You can locate and edit your Store address by [clicking here](https://help.shopify.com/en/manual/intro-to-shopify/initial-setup/setup-business-settings#set-or-change-your-legal-business-name-and-address).

### **Return Name**

```
{{context.shop.name}}
```

### **Return Address**

```
{{context.shop.address1}}
```

### **Return Address 2**

```
{{context.shop.address2}}
```

### **Return City**

```
{{context.shop.city}}
```

### **Return Province**

```
{{context.shop.province}}
```

### **Return Postal Code**

```
{{context.shop.zip}}
```

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FD1CbIjyXpLop4Mqkva3l%2FEF-thanks-io-return-variable.png%20-%20Step%202.png?alt=media&#x26;token=e3a6df0c-00e4-42ca-80c3-6e82f09e0752" alt=""><figcaption></figcaption></figure>
