# 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).


---

# 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/delighted.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.
