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/stamped.io.md).

# Stamped.io

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

When you're setting up your first workflow with Stamped.io, you'll need to add your Domain, Username, and Password so that Stamped.io is a connected app within MESA.

<figure><img src="/files/sAatAqXg7po17TBlnnH6" alt="Screenshot of the MESA workflow builder Stamped.io connection setup, entering the API Key Public, API Key Private, and Store Hash. Spotlight the connection fields."><figcaption></figcaption></figure>

You will find this from your Stamped.io account's [Settings page](https://go.stamped.io/v3/#/settings/api) > API Keys, as API Key Public, API Key Private, and Store Hash.

Back in your MESA workflow, click on Add Connection to finish the process. Afterwards, you can re-use the newly created connection and select it for your future workflows!

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

#### Adding points to a customer <a href="#add-points" id="add-points"></a>

You can build a MESA workflow to automatically add points to a Stamped.io customer profile!

1. To do this and after you have created the first part of your workflow, you can add the MESA's Stamped.io List Customer action.

2. In the Stamped.io List Customer's action Configure field, use the **More Options** button to see the different [Variables ](/workflow-builder/fields/variables.md) to select the customer's Email from a previous step. From there you will select Search, and add the [variable](https://docs.getmesa.com/workflow-builder/fields/variables).

<figure><img src="/files/17IwZy7ZDwpIxL6HRiLm" alt="Screenshot of the MESA Stamped.io List Customer action Configure, opening More Options to reveal variables. Spotlight the More Options button."><figcaption></figcaption></figure>

<figure><img src="/files/5GKN8cZQoUlxCzexh6JB" alt="Screenshot of the MESA Stamped.io List Customer action More Options, selecting Search to add the customer Email variable. Spotlight the Search field."><figcaption></figcaption></figure>

<figure><img src="/files/jfjrlfDCIXGmxVPpPBWq" alt="Screenshot of the MESA Stamped.io List Customer action, adding the customer Email variable from a previous step into the Search field. Spotlight the Email variable."><figcaption></figcaption></figure>

{% hint style="info" %}
If your workflow does not have this information, you will need to add an action that can provide the Shopify Customer's email. See the screenshot below for an example.
{% endhint %}

<figure><img src="/files/664CNjCjdPaGhs3Cgi7H" alt="Screenshot of a MESA workflow showing an added action that provides the Shopify Customer email for the Stamped.io search. Spotlight the action supplying the customer Email."><figcaption></figcaption></figure>

3. Next, click on the **+** sign to add another action. Select MESA's Stamped.io Retrieve Customer action.

4. In the Stamped.io Retrieve Customer's Step Configure field, use the variables feature and select the Stamped.io List Customer Results Customer ID variable.

<figure><img src="/files/0dZzzc3c9obX3WiD1OzJ" alt="Screenshot of the MESA Stamped.io Retrieve Customer action Configure, using the variables feature for the Customer ID field. Spotlight the Customer ID field."><figcaption></figcaption></figure>

<figure><img src="/files/Alr39TZJDMg9hzsSUDQB" alt="Screenshot of the MESA Stamped.io Retrieve Customer action, selecting the Stamped.io List Customer Results Customer ID variable. Spotlight the Customer ID variable."><figcaption></figcaption></figure>

<figure><img src="/files/48STau1tJ44Hsjpscsz3" alt="Screenshot of the MESA Stamped.io Retrieve Customer action with the Customer ID variable added to the field. Spotlight the Customer ID field."><figcaption></figcaption></figure>

5. Next, add another action. Select the Stamped.io Add Points Adjustment to Customer action.

6. In the Configure step to fill in the Customer ID field, use the variables feature to select the Stamped.io Retrieve Customer Customer ID variable.

<figure><img src="/files/F5amBoyll4Wcjoor6cpl" alt="Screenshot of the MESA Stamped.io Add Points Adjustment to Customer action Configure, using the variables feature for the Customer ID field. Spotlight the Customer ID field."><figcaption></figcaption></figure>

<figure><img src="/files/eW0z2VPTvbt48lBK0NGd" alt="Screenshot of the MESA Stamped.io Add Points Adjustment to Customer action, selecting the Stamped.io Retrieve Customer Customer ID variable. Spotlight the Customer ID variable."><figcaption></figcaption></figure>

7. Lastly, fill out the number of points in the Points field. Then, for the Reason field, add a reason for why you are adding points to the customer. These fields are required.

<figure><img src="/files/9r9IEvtMVWoDgEwHtgFL" alt="Screenshot of the MESA Stamped.io Add Points Adjustment to Customer action, filling out the number of points and a reason. Spotlight the Points and Reason fields."><figcaption></figcaption></figure>

8. At the top or bottom of the workflow, hit the Save changes button.

9. Hit the toggle to switch it to On when you are ready to start using the workflow. Save your changes and then [test the workflow out](/workflow-builder/testing.md)!

### I don't see my Stamped.io workflow activating when I update something in Stamped.io? <a href="#triggers" id="triggers"></a>

For Stamped.io [triggers](/workflow-builder/triggers.md) (such as Review Created), there may be a delay of up to a couple hours from when the review was created or updated in Stamped.io to when it is received by MESA. This is the normal behavior of the [Stamped.io](http://stamped.io/) API. As a result, you may not see immediate activity in your MESA workflow.