## Set up Alteryx

URL: https://docs.atlan.com/apps/connectors/etl-tools/alteryx/how-tos/integrate-alteryx

> Set up real-time integration between Alteryx and Atlan using OpenLineage to automatically catalog assets and create lineage when workflows run.

Set up real-time integration between Alteryx and Atlan using OpenLineage. This integration automatically catalogs assets and creates lineage in Atlan whenever workflows run in Alteryx, providing immediate visibility into your ETL processes.

## Prerequisites

Before you begin, make sure you have:
* Admin or Workflow Admin permissions in Atlan to create workflows and generate API tokens
* Administrator access in Atlan to configure OpenLineage integrations
* An [API token](https://docs.atlan.com/llms/platform/get-started/api-authentication/llms.txt) for authentication
* Alteryx Server version [`2025.2`](https://help.alteryx.com/current/en/release-notes.html) or later
* [Alteryx One Platform](https://help.alteryx.com/aac/en/release-notes/release-notes-for-alteryx-one.html#release-notes-for-alteryx-one-platform), the unified deployment of Alteryx Designer, Server, and Alteryx Analytics Cloud

## Create workflow in Atlan

To set up the Alteryx integration, you first need to create a workflow in Atlan that listens for OpenLineage events sent from Alteryx.

1. In your Atlan workspace, click **Connectors** in the left sidebar.
 * If you are using the **Old UI (Classic)**, click **New Workflow** in the top navigation.

2. Click **Marketplace**.

3. Search for **Alteryx** and select it.

4. Click **Install**.

5. Once installation completes, click **Setup Workflow** on the same tile.

5. Click **Create Listener** to create a listener workflow that receives OpenLineage events from Alteryx.

## Configure connection

To connect Alteryx with Atlan, you need to configure a connection that receives OpenLineage events from Alteryx. This connection enables Atlan to automatically capture and catalog Alteryx assets whenever workflows run.

:::warning **Important**
Each connection (namespace) must be linked to only one Alteryx instance. Using the same connection across multiple instances can cause environment variables to update incorrectly and lead to unexpected behavior.
:::

1. In your Atlan workspace, go to the **Connections** page.

2. Click **New connection** and select **Alteryx** as the source.

3. In the **Connection Name** field, enter a name that represents your environment, for example, `production`, `development`, or `analytics`.

4. (Optional) Under **Connection Admins**, specify the users or groups who can manage this connection. If no user or group is specified, the connection can't be managed, not even by admins.

5. Click **Create connection** to save and activate it.

Once configured, Atlan begins listening for OpenLineage events sent from Alteryx and automatically creates Alteryx assets and lineage when workflows run.

## Configure integration in Alteryx

An Alteryx administrator configures Atlan's OpenLineage integration in Alteryx as follows:

1. In Alteryx, navigate to **Admin Console → Data Lineage Connection**.

2. Under **Data Consumer**, click **Set up** for an external data catalog.

3. On the **Data Catalog Setup** page, select **Atlan** as the external catalog.

4. In the **OpenLineage Endpoint** field, enter the full URL where Alteryx sends OpenLineage event data:
	```
	https://<instanceName>.atlan.com/events/openlineage/alteryx/api/v1/lineage
	```
5. In the **OpenLineage Namespace** field, enter the connection name of your Alteryx connector in Atlan.

6. Under **Auth Method**, select **Bearer Token** and enter your Atlan API token for authentication.

7. Under **Data Lineage Level**, choose **Dataset** or **Column**. If you don't select `Column`, Atlan only receives dataset-level information and creates lineage at the asset level.

Once this configuration is saved, Alteryx begins sending OpenLineage events to Atlan automatically whenever workflows run.

## Verify connection

After you configure the integration, verify that Atlan is successfully receiving OpenLineage events from Alteryx.

1. In Alteryx, run a workflow to trigger OpenLineage events.

2. In Atlan, open the configured connection and check for newly created **Alteryx assets**.

3. Open an asset to confirm that **lineage information** from the Alteryx workflow appears in the asset view.

4. (Optional) Go to [View event logs](https://docs.atlan.com/llms/governance/access-control/view-event-logs/llms.txt) in Atlan to review the OpenLineage events and verify successful ingestion.

Atlan validates the connection by ensuring the connection name matches and the API token is valid. Once the workflow runs in Alteryx, corresponding assets and lineage are automatically created and updated in Atlan.

## Next steps

* [API authentication](https://docs.atlan.com/llms/platform/get-started/api-authentication/llms.txt): Learn how to generate and manage API tokens for authentication

---