# Lookup

{% hint style="info" %}
See the changelog of this Action type [here](https://app.gitbook.com/s/IXj83By4f20oCrZZ0gyP/lookup).
{% endhint %}

## Overview

The **Lookup** action allows you to retrieve information from your uploaded lookups. To learn more about how to upload data, go to [**Enrichment**](https://docs.onum.com/the-workspace/enrichment).

<figure><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2F5VIHgU2tAJ5eQUb9xrvt%2Flookup%20compressed.gif?alt=media&#x26;token=1b8767a1-dfbe-4cb3-95e1-4308d728a97a" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
In order to configure this action, you must first link it to a Listener. Go to [Building a Pipeline ](https://docs.onum.com/the-workspace/pipelines/building-a-pipeline)to learn how to link.
{% endhint %}

## Ports <a href="#ports" id="ports"></a>

These are the input and output ports of this Action:

<details>

<summary>Input ports</summary>

* **Default port** - All the events to be processed by this Action enter through this port.

</details>

<details>

<summary>Output ports</summary>

* **Default port** - Events are sent through this port if no error occurs while processing them.
* **Error port** - Events are sent through this port if an error occurs while processing them.

</details>

## Configuration

{% stepper %}
{% step %}
Find **Lookup** in the **Actions** tab (under the **Enrichment** group) and drag it onto the canvas. Link it to the required [Listener](https://docs.onum.com/the-workspace/listeners) and [Data sink](https://docs.onum.com/the-workspace/pipelines/data-sinks).
{% endstep %}

{% step %}
To open the configuration, click the Action in the canvas and select **Configuration**.
{% endstep %}

{% step %}
Enter the required parameters:

<table><thead><tr><th width="167">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Select table</strong><mark style="color:red;"><strong>*</strong></mark></td><td>Select the table you wish to retrieve data from. The tables that show here in the list will be those you previously uploaded in the <strong>Enrichment</strong> view.</td></tr><tr><td><strong>Key columns</strong></td><td>The <strong>Key column</strong> you selected during the upload will automatically appear. Select the field to search for this key column.</td></tr><tr><td><strong>Outputs</strong></td><td>Choose the field that will be injected from the drop-down and assign it a name. Add as many as required.</td></tr></tbody></table>
{% endstep %}

{% step %}
Click **Save** to complete.
{% endstep %}
{% endstepper %}