> For the complete documentation index, see [llms.txt](https://docs.getmesa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getmesa.com/connect/thanks.io.md).

# 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&amp;token=ee557555-3c6c-4414-8582-85fb59496f72" alt="Screenshot of the thanks.io step in a MESA workflow prompting for the private API key. Spotlight the API key field."><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&amp;token=7a9e8a46-490b-45fc-860c-fff4b9083095" alt="Screenshot of the thanks.io Dashboard API Access page under Personal Access Tokens with a name entered. Spotlight the Create button."><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](/going-further/credentials.md) 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&amp;token=57754d0f-a9f4-4ebd-b304-91a75cf47545" alt="Screenshot of the thanks.io Personal Access Token being shown for the first time to copy. Spotlight the token text box."><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](/workflow-builder/triggers.md).

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

In the Letter Send, Notecard Send, and Postcard Send [actions](/workflow-builder/triggers.md), 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](/workflow-builder/triggers.md), there will be some configuration fields set for a Return address.

You can copy and paste the following [variables](/workflow-builder/fields/variables.md) 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&amp;token=e3a6df0c-00e4-42ca-80c3-6e82f09e0752" alt="Screenshot of the Return address configuration fields in a thanks.io Send action with store address variables entered. Spotlight the Return address fields."><figcaption></figcaption></figure>
