Skip to main content

Integrating Air with Workato

Air's Workato connector lets you move assets, boards, tags, and custom field data between Air and the other tools in your stack — no code required. This article covers how to connect Air to Workato and how to use the available actions to build recipes.

Written by Brady Brown

Before you start

Air's API is available on eligible Business and Enterprise workspaces. You'll need two things from Air before connecting:

What you need

Where to find it

API Key

Workspace Settings → API Access

Workspace ID

Workspace Settings → API Access

Keep these handy — you'll enter both when you create the connection in Workato.

Connecting Air to Workato

  1. In Workato, create or open a recipe and search for Air when choosing an app.

  2. When prompted to connect, enter your API Key and Workspace ID.

  3. Save the connection. Workato will verify your credentials against your Air workspace automatically.

Once connected, that connection is available to any Air action across your Workato recipes — you don't need to reconnect for each new recipe.

What the connector can do

The Air connector is action-only — it does not currently expose a polling or webhook trigger. That means an Air step can't start a recipe on its own; pair it with a trigger from another app (a form submission, a new row in a spreadsheet, an upload to cloud storage) or with Workato's Scheduler, then have your recipe call Air actions to do the work.

Actions are grouped below by what they operate on.

Assets

  • Upload asset

  • Import asset from URL

  • Get asset

  • List assets

  • Delete asset

  • List asset versions

  • Get asset version

  • Update asset version

  • Get asset version download URL

  • List asset's parent boards

  • Get import status

  • Complete multipart upload

  • Get multipart upload part URL

Boards

  • Create board

  • Update board

  • Delete board

  • List boards

  • Get board

  • Add assets to board

  • Remove asset from board

  • Add guest to board

  • Remove guest from board

  • Update board guest role

  • List board guests

Custom fields

  • Create custom field

  • Update custom field

  • Delete custom field

  • List custom fields

  • Get custom field

  • Add custom field value

  • Set custom field value on asset

  • Set custom field value on board

  • Update custom field value

  • Delete custom field value

Tags

  • Create tag

  • Update tag

  • Delete tag

  • List tags

  • Add tag to asset version

  • Remove tag from asset version

Libraries

  • Create library

  • Update library

  • Delete library

  • List libraries

  • Get library

CDN links

  • Create CDN link

  • Activate or deactivate CDN link

  • List asset CDN links

  • (Legacy) Create evergreen CDN link

  • (Legacy) Create version-pinned CDN link

Other

  • List roles

Working with custom fields

Custom field actions (Add custom field value, Set custom field value on asset/board, Update custom field value) work off of field and option IDs, not display labels. Before wiring these into a recipe:

  1. Run Get custom field (or List custom fields) to look up the field's ID.

  2. For select-type fields, confirm the option IDs against the field definition — don't assume they match what's shown in the Air UI.

  3. Reference those IDs in your recipe's Air action steps.

Validating IDs this way avoids writing a field update that silently applies the wrong option.

Import asset from URL

To bring assets into Air from another system (cloud storage, a DAM, a form upload), use Import asset from URL rather than Upload asset when you're passing a link instead of binary file data. The source URL must be publicly accessible so Air's import service can retrieve it. You can optionally set a filename, target board, tags, and custom field values in the same step.

Because imports are processed asynchronously, use Get import status if your recipe needs to confirm the asset finished importing before continuing (for example, before tagging it or adding it to a board).

Example recipes

  • New file in cloud storage → import to Air. Trigger on a new file in Drive/Dropbox/S3, generate a shareable link, then call Import asset from URL to bring it into a specific board.

  • Form submission → tagged upload. Trigger on a form response, upload or import the attached asset, then use Add tag to asset version and Set custom field value on asset to apply metadata from the form fields.

  • Scheduled board sync. On a Workato schedule, call List assets with a filter, then Add assets to board to keep a board current with assets matching that filter.

  • New board creation. Trigger from a project-management tool (e.g., a new record in a tracker), then call Create board and Add guest to board to spin up a workspace for a new project automatically.

Limitations & tips

  • No native Air trigger. Every recipe needs a trigger from another app or Workato's Scheduler — Air steps only ever run as actions.

  • Rate limits apply. High-volume recipes (bulk tagging, bulk custom field writes) can hit Air's API rate limits. Add error handling with retry/backoff in Workato for any step that loops over many assets.

  • Uploads vs. imports. Use Upload asset for binary files you already have in the recipe; use Import asset from URL for anything reachable by a public link.

  • Look up IDs before writing. Board, tag, and custom field actions all expect IDs. Add a lookup step (Get/List action) ahead of any Create/Update/Set action rather than hardcoding IDs that could change.

Questions about a specific recipe or action not covered here? Reach out to your Air account team.

Related Articles
Did this answer your question?