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

# Govalo

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

When you're setting up your first workflow with Govalo, you'll need to create a connection by clicking on the **Connect with Govalo** button.

**Important:** You must have the Govalo by Govalo app installed on your Shopify store before authenticating with Govalo. [Click here to install the app.](https://apps.shopify.com/govalo)

![Screenshot of a MESA workflow Govalo authentication step. Spotlight the Connect with Govalo button.](/files/odFNl6UYpwOn3A8ZKck0)

You will see a modal in the Govalo app. Click on the **Approve** button to complete the process. You are all set and you can re-use the newly created connection for your future workflows!

### Configuration <a href="#configuring" id="configuring"></a>

#### Create Webhooks for Govalo Triggers <a href="#webhooks" id="webhooks"></a>

**Important:** MESA's Govalo Triggers can only be used by Govalo Premium and Enterprise customers at this time.

When using a Govalo Trigger with Govalo, you will need to create a webhook in your **Govalo** Shopify App.

<figure><img src="/files/YMeAfFfPhutw21qEWdgM" alt="Screenshot of a MESA Govalo trigger that requires creating a webhook in the Govalo Shopify App. Spotlight the Govalo trigger."><figcaption></figcaption></figure>

**Follow these instructions to set up your webhook in Govalo.**

1\. In a new tab on your browser, visit the Govalo app from your Shopify Admin's **Apps** page.

{% hint style="info" %}
These instructions assume that you have created a gift card in Govalo already. If you have not, [please configure your first gift card](https://support.govalo.com/article/83-setting-up-govalo) first. Then, proceed to Step 2.
{% endhint %}

2\. Click on **Configure** from the left side bar navigation.

![Screenshot of the Govalo app. Spotlight the Configure option in the left sidebar navigation.](/files/mM1r7vvBFe0R1Pu44imU)

3\. Then, click on **Webhooks** under the General section. If you do not see **Webhooks** under the **General** section, please contact the [Govalo support](https://support.govalo.com/) to help enable webhooks on your store.\
You can mention that you wish to enable Webhooks on your store (https\://\[\[store domain]].myshopify.com/).

![Screenshot of the Govalo app Configure page. Spotlight the Webhooks option under the General section.](/files/TrIIY4UFdsrfqfvyx3CE)

4\. Going back to MESA, locate your workflow with the Govalo Trigger and click on the Govalo Trigger.

5\. Click on the **Edit** button.

6\. Then, click on the Copy icon next to the **Webhook URL** field.

![Screenshot of a MESA Govalo trigger opened with Edit, click the Copy icon next to the Webhook URL field. Spotlight the Copy icon next to the Webhook URL.](/files/NZDXsRvKqtoaoYevKMOD)

7\. Go back to the tab with the Govalo app open.

8\. In the Webhook URL field, paste the URL that you just copied from MESA.

9\. You will then want to select the topics which corresponds to the Govalo you added in your workflow. So for MESA's Govalo **Gift Card Created** [trigger](/workflow-builder/triggers.md), you should select **Gift card created** under **Select topics**, as we only want to receive data for this one topic. The topic selected will vary depending on your Govalo trigger.

![Screenshot of the Govalo app webhook setup, paste the copied Webhook URL and select the topic matching your trigger such as Gift card created. Spotlight the Select topics field.](/files/fIl4rb20bqtAWI6W7WB4)

10\. After selecting the relevant topics for your webhook, click on **Save**. You are all set! Head back over to MESA. 😊

#### Create Card action <a href="#create-card" id="create-card"></a>

The **Create Card** action is currently only available to merchants on the [Govalo Enterprise plan](https://govalo.com/pages/pricing) at this time.

![Screenshot of the MESA Govalo Create Card action. Spotlight the Create Card action step.](/files/D3rhvcNcxobARJJsqKo2)

When adding a **Create Card** action, you will need to fill out some **required** fields before being able to save your workflow.

**Required Fields:**

* **First Name:** The recipient's first name.
* **Last Name:** The recipient's last name.
* **Email:** The recipient's email address.
* **Value:** The gift card value. Whole numbers are recommended. **Example:** 10
* **Event Type:** This is defined by you. Normally used to label why the Gift Card was given. **Example:** birthday
* **Product ID:** The Govalo Gift Card's Shopify Product ID. Click on the Gift Card product that you want to get the Product ID for > Go to the URL at the top and copy the number that comes after **/products/**. Example: **6767472148503** from ../products/6767472148503
