Skip to main content

Setting up an Air node for n8

This guide walks you through setting up the official Air node in n8n, allowing you to securely connect your Air workspace and start building workflows that interact with your assets and metadata.

Lauren Ford avatar
Written by Lauren Ford
Updated this week

Who can set up an Air node for n8n?
​

👨‍👩‍👧‍👦 Supported on any Enterprise Air plan

✏️ Anyone with workspace owner or admin access to the workspace

The Air node for n8n requires two values to authenticate:

  1. API Key – Used to securely authenticate requests to Air

  2. Workspace ID – Identifies which Air workspace n8n should connect to

Both values are available in your Air workspace settings.

Create and retrieve your Air API key

Take care to keep your API key confidential and do not disclose it to others, either by sharing it directly or by displaying it in your browser or the n8n software.

  1. Log in to your Air workspace and navigate to API Access within your workspace settings

  2. Select '+Create a new API Key'

    • The API key is shown only once

    • Copy it immediately and store it in a secure location

Locate and retrieve your Workspace ID

When making a request with the Air node for n8n, it is necessary to include the workspace id for the specific workspace you want to use. This lets the API know which workspace the request is related to.

  1. Find the name of your workspace under the Workspace ID header

  2. Click to copy the Workspace ID next to your workspace name

Option 1: Create credentials from the n8n Credentials menu

This method is recommended if you want to set up credentials before building a workflow.

  1. In n8n, open the Credentials section

  2. Click Create New Credential

  3. Search for Air API

  4. Select the Air credential type

  5. Paste in:

    • Your Air API Key

    • Your Air Workspace ID

  6. Save the credential

Your Air credentials are now ready to be used in any workflow.

Option 2: Create credentials directly from a workflow

You can also create credentials while configuring an Air node inside a workflow.

  1. Open an existing workflow or create a new one in n8n

  2. Add a new node

  3. Search for Air and select the Air node

  4. Choose an action (for example: Get Assets)

  5. In the Credentials field, click Create New

  6. Enter your:

    • API Key

    • Workspace ID

  7. Save the credential

The node will now be connected to your Air workspace.

Verify your Air node for n8n setup

Once credentials are configured:

  • Select an Air action (such as retrieving assets)

  • Execute the workflow

  • Confirm that data is returned successfully

If the node fails to authenticate, double‑check that:

  • The API key was copied correctly

  • The Workspace ID matches your Air workspace

  • Your user account has admin permissions

Related Articles
Explore Asset Info Tab + Metadata
Explore Air Flow
Configuring SAML SSO
Explore Air for Zapier
Setting up an approval workflow on Air
Did this answer your question?