Integrating Air with Make

You'll need two things from your Air workspace:
​

1. API Key — go to app.air.inc, open Settings → API, and generate or copy your key

2. Workspace ID — go to Settings → Workspace and copy your Workspace ID

​

​

Your connection is shared across all Air modules in your Make account. You only need to set it up once.

Runs on a schedule and fires once for each new asset added to your workspace.
​

Setup:

1. Set a From date — assets created after this date will be returned. Pick a recent date to avoid processing your entire backlog on the first run.

2. Optionally filter by Board ID to watch a specific board only.

3. Enable Include Nested Assets to also pick up assets in sub-boards.

Output includes: asset ID, title, file type, created/updated timestamps, thumbnail URL, tags, and custom fields.
​

Tip: Connect this to an Apply Custom Field to Asset module to automatically tag or categorize assets as they're uploaded.

Returns a list of assets from your workspace. Use this when you need to fetch assets on demand rather than watching for new ones.

​

Filters available:

- Board ID — limit results to a specific board

- Search Query — filter by title or metadata keywords

- Tags — filter by one or more tag IDs (assets must match all tags)

- Custom Fields — filter by custom field values

- Created At (From / To) — filter by creation date range

- Include Nested Assets — include assets from sub-boards

Returns a single asset by its unique ID. Use this when you already have an asset ID and need to fetch its full details.
​

Returns boards from your workspace. Use this to look up board IDs for use in other modules.
​

Returns all custom fields defined in your workspace, including field IDs and available option value IDs for select fields. Use this to find the IDs you need when configuring Apply Custom Field to Asset or Apply Custom Field to Board.
​

Returns all tags in your workspace. Use this to find tag IDs for use in Update Asset actions.

Imports a file into Air directly from a URL. Air fetches and processes the file server-side — no manual upload required.
​

Required:

- Source URL — must be publicly accessible. Files from Google Drive, Dropbox, S3, or any CDN work well here.

​

Optional:

- File Name — if omitted, Air infers it from the URL

- Board ID — the board to place the asset in

- Tags — tag IDs to apply on import

- Custom Fields — custom field values to apply on import

​

Output: import ID, asset ID, version ID.

​

Note: The import is processed asynchronously. Air may take a few seconds to fully ingest the file after the module completes.
​

Adds one or more assets to a board.

Required:

- Board ID — the destination board

- Assets — one or more asset IDs to add
​

Sets or unsets the value of a custom field on a specific asset.
​

Required:

- Asset ID

- Custom Field ID
​

For plain-text and date fields: enter the value in the Value field.
​

For single-select and multi-select fields: add entries to the Values array using the option's value ID.

​

To find custom field and value IDs, use the Get Custom Fields module.
​

Sets or unsets the value of a custom field on a board. Works the same way as Apply Custom Field to Asset but targets a board instead.

Required:

- Board ID

- Custom Field ID

- Value ID/Values

Creates a new board in your workspace.

Required: Board name.

Optional: Description, parent board ID (to create a nested board)

Updates an existing board's properties such as name or description.

Optional: Title, Description, parent board ID (to create a nested board).

Creates a new custom field in your workspace.

Field types available: Single Select, Multi Select, Plain Text, Date.

For select fields: enter your options in the Options field as a comma-separated list (e.g. `Approved, In Review, Rejected`).
​

Workspaces are limited to 100 custom fields.
​

​

Updates the details of a specific version of an asset.

Optional: Title, Description, parent board ID (to create a nested board).

Custom fields in Air have two components: the field ID and the value ID (for select fields). When configuring modules you'll need both.
​

To find IDs:

1. Add a Get Custom Fields module to your scenario and run it

2. Each field in the output shows its `id`, `name`, `type`, and a `values` array

3. Each entry in `values` has an `id` and `name` — use the `id` when applying values to assets or boards

Auto-import from Google Drive

Trigger: Google Drive → Watch Files in a Folder

Action: Air → Import Asset from URL

Use the Google Drive file's public URL as the source. Apply a board ID and tags automatically on import.

Tag new assets on upload

Search: Air → Poll For New Assets

Action: Air → Apply Custom Field to Asset

Automatically apply a "Status" field value of "New" to every asset as it arrives.
​

Sync assets to a board based on search

Search: Air → Get Assets (filtered by tag or custom field)

Action: Air → Add Assets to Board

Move assets matching specific criteria into a destination board on a schedule.

Create and organize boards dynamically

Action: Air → Create Board

Action: Air → Add Assets to Board

Build board structures programmatically based on data from other tools (e.g. create a board per Airtable record or Notion project).

- Polling only — Air does not currently support instant triggers. Set your Poll For New Assets schedule based on how frequently you need to react to new assets (5–15 minutes recommended).

- Binary uploads not supported — use Import Asset from URL for all file ingestion. Files must be accessible via a public URL.

- First poll run — the first time Poll For New Assets runs, it may return a large number of assets depending on your "From" date. Set a recent date to avoid processing a large backlog.

- Rate limits — Air allows 15 requests per second. Make handles retries automatically if this limit is hit.