# Delighted

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

When you're setting up your first workflow with Delighted, you'll need to add your API key so that Delighted 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%2FgfZGdunwnuLLgfyttjaT%2Fimage.png?alt=media&#x26;token=ab1a5079-3bed-4bc9-9628-14d39b7b7553" alt=""><figcaption></figcaption></figure>

You can locate your [API key](https://help.delighted.com/article/571-the-delighted-rest-api#docs) by clicking Integrations on the Delighted Dashboard. Then, locate API and click on it.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FVhXV5lFIrgDRDE1XFBX3%2FEF-delighted-dashboard.png%20-%20Step%202.png?alt=media&#x26;token=3c2ecc7c-aba1-42f6-a04c-b78278fe90f6" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fxddu789zHdrYpsYl01SD%2FEF-delighted-dashboard.png%20-%20Step%203.png?alt=media&#x26;token=aec5f62a-116f-4f5d-ba0b-6c85070e61df" alt=""><figcaption></figcaption></figure>

You will find the API key under Your API key header. Copy and paste that into your workflow and create a [Delighted Connection](https://docs.getmesa.com/going-further/credentials).

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FRvtajnfJDY4z7LUhsdvL%2FEF-delighted-API-key_png_-_Step_2.png?alt=media&#x26;token=4ab5a61b-2853-407d-a925-0ca963b6d617" alt=""><figcaption></figcaption></figure>

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

### Delighted Triggers <a href="#triggers" id="triggers"></a>

When starting a workflow with a Delighted Trigger, [MESA will require you to create a Webhook before the workflow works successfully.](https://help.delighted.com/article/556-delighted-webhooks)

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FuKPprvL2uyZ1U3ZWnFdB%2FEF-delighted-trigger_png_-_Step_2.png?alt=media&#x26;token=fdf17a60-1319-44f1-a728-adc9a866fffd" alt=""><figcaption></figcaption></figure>

1\. To create a Webhook, you can click Integrations on the Delighted Dashboard. Then, locate Webhooks and click on it.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2F4sssQapyvza5b4MQFK0H%2FEF-delighted-dashboard.png%20-%20Step%202.png?alt=media&#x26;token=873a1e3f-f095-44b1-88f3-7c797eeab763" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fm1evOqzMJaRxmHAdaBzC%2FEF-delighted-webhooks.png%20-%20Step%202.png?alt=media&#x26;token=e46f057d-f342-4de9-a60f-e0629e7f9ef7" alt=""><figcaption></figcaption></figure>

2\. From your MESA workflow, copy the Webhook URL seen in the field (save the workflow if you do not see an URL in the field and refresh the page). Paste the URL into the textbox on the screen.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FlCUZzMT1ZM74SvZvUJx3%2FEF-delighted-webhooks-URL.png%20-%20Step%202%20(1).png?alt=media&#x26;token=5d75b9f6-4f05-4838-a997-85fbfea87723" alt=""><figcaption></figcaption></figure>

3\. \*\*Optional Settings:\*\*For response notifications: Set the specifications of the webhook rule (like “promoters only”)For unsubscribe notifications: Select Send unsubscribe notifications. Click Save & turn on.

### Delighted Get & List Actions <a href="#get-list" id="get-list"></a>

Delighted has several actions that can retrieve or list out items like surveys, people, and etc.

In order to retrieve a specific list of things, you will need to use our Parameters option. If you want to list out all things, you can leave the parameter option unselected.

Parameters are what helps MESA request for specific information.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FIdgILAmZovCEXPmlf0m6%2FEF-delighted-parameters.png%20-%20Step%202.png?alt=media&#x26;token=995982e4-728e-4990-87a4-2cd20da8b810" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2F8pb9OKTAl4FhQXyb7xTH%2FEF-delighted-parameters.png%20-%20Step%203.png?alt=media&#x26;token=3bb42aad-08a8-483b-862e-62ef6f1afe3d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FzmCI9l2XqoVwceUXrqi0%2FEF-delighted-parameters.png%20-%20Step%204.png?alt=media&#x26;token=700a5f28-5818-4563-8a61-0d441ecadcb6" alt=""><figcaption></figcaption></figure>

To use multiple parameters, you will want to add a "&" symbol between multiple parameters. You can also use [variables](https://docs.getmesa.com/workflow-builder/fields/variables) in the parameters.

If you are not sure what parameter to add, you can check the [Delighted API documentation](https://app.delighted.com/docs/api).
