## n8n integration

n8n is a workflow automation platform that lets teams build and run integrations between apps and services. Integrating n8n with Frontegg allows your application to access automation data — including workflows, executions, credentials, and variables — on behalf of your users through API key authentication.

Prerequisites
- An n8n account (Cloud or self-hosted)
- Admin access to your n8n instance


### Connect n8n

#### Step 1: Open API settings

Sign in to your n8n instance. In the left sidebar, click **Settings**, then select **n8n API**.

This page lists all your existing API keys and lets you create new ones. Click **Create an API Key** to continue.

![n8n API settings page with Create an API Key button highlighted](/assets/n8n-5.2293a11c910c969dcce8f28ca9cb274f29f401eee4dd46213b7848259de8a28a.1ce25488.png)

#### Step 2: Name and create the key

In the **Create API Key** dialog, enter a label for your key — for example, `Frontegg Integration`. Then click **Save**.

![Create API Key dialog with Frontegg Integration label entered and Save button highlighted](/assets/n8n-6.f532078e64a33b08a1057ac05d39a2a8295f88c7d1d98a8236d7fb326c3d03ac.1ce25488.png)

#### Step 3: Copy your API key

After saving, n8n displays your new API key. Copy the key value and store it securely.

Save your key now
The full API key value is only shown immediately after creation. Once you dismiss this dialog, only the masked version is displayed. Store the key in a secure location before continuing.

![API Key Created dialog showing the generated key value](/assets/n8n-7.27d5eb462b01ef4b56893558dce0efc40e9b9b1b538f0156743ec4e5211d5ae1.1ce25488.png)

#### Step 4: Verify the key was created

After dismissing the dialog, your new key appears in the **API Keys** list on the n8n API settings page.

![n8n API settings page showing the newly created Frontegg Integration API key in the list](/assets/n8n-8.9351827cd6b9a16b7cee6e1739585cdda26f672fea2c1ebb7ff36f255cc6dba7.1ce25488.png)

### Configure the Frontegg portal

Once you have your API key from the steps above, enter it in the integration configuration page of the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → n8n.
2. Enter the **API Key** you copied in Step 3 in the corresponding field.
3. Click **Save**.


Keep your key secure
Never share or commit your API key to version control.

### Available scopes

When Frontegg calls the n8n API on behalf of your users, the following permission scopes apply:

| Scope | Description |
|  --- | --- |
| `workflow:read` | Read workflows |
| `workflow:write` | Create, update, and delete workflows |
| `workflow:execute` | Execute workflows |
| `execution:read` | Read execution data |
| `execution:write` | Delete executions |
| `credential:read` | Read credential metadata |
| `credential:write` | Create, update, and delete credentials |
| `user:read` | Read user information |
| `user:write` | Manage users |
| `audit:read` | Generate security audits |
| `variable:read` | Read variables |
| `variable:write` | Manage variables |
| `tag:read` | Read tags |
| `tag:write` | Manage tags |
| `project:read` | Read projects |
| `project:write` | Manage projects |
| `sourceControl:read` | Read source control |
| `sourceControl:write` | Pull from source control |


### Additional resources

- [n8n API documentation](https://docs.n8n.io/api/)
- [n8n API authentication guide](https://docs.n8n.io/api/authentication/)
- [n8n self-hosting guide](https://docs.n8n.io/hosting/)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)