# Yotpo Loyalty

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

When you're setting up your first workflow with Yotpo Loyalty & Rewards, you'll need to add your unique API Key and GUID so that Yotpo Loyalty & Referrals 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%2F4fQqtJwGnz13YVQ0Hszp%2Fimage.png?alt=media&#x26;token=47c82334-9d3b-4a4d-9d31-c7f51bbb0485" alt=""><figcaption></figcaption></figure>

You can find both the API Key and GUID in your Yotpo Loyalty & Rewards app > Settings > [General](https://loyalty.yotpo.com/general-settings)**.**

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FaES87aSRkrGu93zPRQGQ%2Fimage.png?alt=media&#x26;token=40943d7f-69d5-47bf-b8a5-f2f88efb85e0" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2F5VdMoQVX14MYGu8i7wYV%2Fimage.png?alt=media&#x26;token=f7970027-fbb7-4c89-931b-7a384e1e432b" alt=""><figcaption></figcaption></figure>

Add the API Key field to the Key field in the connection, and GUID value to the Secret field.

Lastly, in your MESA workflow, click on Add Connection and then you are all set.

### Configure <a href="#configuration" id="configuration"></a>

#### Triggers and Webhooks <a href="#yotpoloyalty-webhooks" id="yotpoloyalty-webhooks"></a>

{% hint style="info" %}
Starting a workflow with a Yotpo Loyalty trigger requires a Yotpo's Premium or Enterprise plans.
{% endhint %}

When you're setting up your first trigger for Yotpo Loyalty & Rewards, you'll need to add the Webhook URL to your Yotpo Loyalty & Rewards account, so updates are sent to MESA.

Create a workflow with a Yotpo Loyalty & Referrals [Trigger](https://docs.getmesa.com/workflow-builder). Copy the Webhook URL value under Configuration. If it's blank, save and/or refresh the workflow.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FNPME0ourlr0eKHfcQEx1%2Fimage.png?alt=media&#x26;token=7d4be608-7bde-4e4c-bb98-5af3a8b07d1a" alt=""><figcaption></figcaption></figure>

In your Yotpo Loyalty & Rewards app, go to Settings > General, then paste into the Webhook URL field and hit Save. If you already have value(s) in that field, add a **;** (semi-colon) before the pasted value, so that updates can be sent to MESA, in addition to your existing integrations.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FGYaMgLcnYN0QWphdi8q6%2Fimage.png?alt=media&#x26;token=a5d76f05-87aa-4328-bfa8-c864c2269f4d" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getmesa.com/connect/yotpo-loyalty.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.