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

# 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="/files/3oYzwPvBPCXDWW2G4HMH" alt="Screenshot of the MESA Delighted connection setup where you add your Delighted API key to make Delighted a connected app. Spotlight the API key field."><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="/files/Arpf5gnUGg36RiMHHD54" alt="Screenshot of the Delighted Dashboard where you locate your API key. Spotlight the Integrations menu."><figcaption></figcaption></figure>

<figure><img src="/files/xJWGHchCoMgVWNuG2IbA" alt="Screenshot of the Delighted Dashboard Integrations page after clicking Integrations. Spotlight the API option."><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](/going-further/credentials.md).

<figure><img src="/files/ia3NPuF5Q3Y2cYfsb98k" alt="Screenshot of the Delighted API page showing the key to copy for the MESA connection. Spotlight the value under the Your API key header."><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="/files/ghRxKFTpaqTigZaEFvUc" alt="Screenshot of a MESA workflow started with a Delighted trigger, which requires creating a Webhook before it runs. Spotlight the Webhook URL field."><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="/files/Arpf5gnUGg36RiMHHD54" alt="Screenshot of the Delighted Dashboard where you begin creating a Webhook. Spotlight the Integrations menu."><figcaption></figcaption></figure>

<figure><img src="/files/HvOFIs2fx1bOVlN4cUjS" alt="Screenshot of the Delighted Dashboard Integrations page while creating a Webhook. Spotlight the Webhooks option."><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="/files/wbDQkMWKaEvfD25lvo9N" alt="Screenshot of the Delighted Webhooks setup where you paste the Webhook URL copied from the MESA workflow. Spotlight the webhook URL textbox."><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="/files/fTiB9iLgex4EwJl3Hzmh" alt="Screenshot of a MESA Delighted Get or List action where the Parameters option is used to request specific information. Spotlight the Parameters option."><figcaption></figcaption></figure>

<figure><img src="/files/s0pDO2DDuInDnN8TzH9J" alt="Screenshot of a MESA Delighted Get or List action with the Parameters option enabled to enter a parameter. Spotlight the Parameters field."><figcaption></figcaption></figure>

<figure><img src="/files/YDmLeer9sj012wUsBYSH" alt="Screenshot of a MESA Delighted Get or List action with a completed parameter value entered to filter the request. Spotlight the entered parameter value."><figcaption></figcaption></figure>

To use multiple parameters, you will want to add a "&" symbol between multiple parameters. You can also use [variables](/workflow-builder/fields/variables.md) 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).