Skip to content
Start in the sandbox
All connectors
Asana logo

Asana

Project & work management

Turn requests and orders into Asana work, and keep status in step across your tools.

38 ways to read, 23 ways to write, each write switched on by you.

Try this in the sandboxBring us a workflow

Quality checks

Built and tested with example responses.

  1. Ready to connect: doneEvery listed action is built in.
  2. Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Asana with Nexra

Connected, approved, proven.

The things teams do most with Asana, an example flow with a person in the loop, and what Nexra keeps as proof.

Top actions

  • Add task commentcomments.createApproval by rule
  • Create custom fieldcustom_fields.createApproval by rule
  • List task attachmentsattachments.listRead

Example flow

  1. Asana · List task attachmentsattachments.listDone
  2. Asana · Add task commentcomments.createMaker-checker
  3. Nexra · Record the decision and result in the evidence chainProven

Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Asana.

What gets logged

  • Whether it ran on its own or who approved it, and under which rule
  • A fingerprint of the exact request sent to Asana
  • Asana's reply: what it created or changed
  • One entry in the evidence chain, linked to the one before

Try this in the sandbox

Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.

Try this in the sandboxBring us a workflow

For developers

Technical detail

Read and write Asana tasks, subtasks, dependencies, comments, projects, sections, goals, tags, custom fields, time entries and status updates; read portfolios, teams and events.

Asana, Inc. API docs
Source actions
38
Destination actions
23
Data types
27

What you can map

Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.

attachments2
  • Get attachment metadataSource

    Metadata for one attachment; the file is not downloaded.

  • List task attachmentsSource

    Attachment metadata for a task.

comments3
  • Add task commentDestinationNot retried automaticallyApproval before production

    Adds a comment to a task.

  • List task commentsSource

    Comment stories on a task; system activity is excluded.

  • Update task commentDestinationProvider duplicate protectionApproval before production

    Replaces the text of a comment story, or pins or unpins it.

custom fields4
  • Create custom fieldDestinationNot retried automaticallyApproval before production

    Creates a text, number, date, enum or multi-enum custom field in the workspace.

  • Get custom fieldSource

    One custom field definition with its options.

  • List custom field definitionsSource

    Custom fields in the workspace with types and enum options.

  • Update custom fieldDestinationProvider duplicate protectionApproval before production

    Updates a custom field's name, description or number precision. The type cannot change.

dependencies2
  • Add task dependenciesDestinationProvider duplicate protectionApproval before production

    Marks a task as dependent on other tasks.

  • List task dependenciesSource

    Tasks that must be completed before this task.

dependents2
  • Add task dependentsDestinationProvider duplicate protectionApproval before production

    Marks other tasks as waiting on this task.

  • List task dependentsSource

    Tasks waiting on this task.

events1
  • List resource eventsSourceIncremental

    Changes to a task, project or goal since a sync token. Each event carries the next sync token to store for the following run.

followers1
  • List task followersSource

    Users following a task.

goal metrics1
  • Set goal metric valueDestinationProvider duplicate protectionApproval before production

    Sets the current value of a goal's numeric metric, for example from a KPI system.

goals4
  • Create goalDestinationNot retried automaticallyApproval before production

    Creates a goal in the configured workspace.

  • Get goalSource

    One goal with owner, period, status and metric.

  • List goalsSource

    Goals in the workspace, optionally for a team, project, portfolio or time period.

  • Update goalDestinationProvider duplicate protectionApproval before production

    Updates a goal's name, notes, owner, period, dates or status.

milestones2
  • Create milestoneDestinationNot retried automaticallyApproval before production

    Creates a milestone task in a project.

  • List project milestonesSource

    Milestone tasks in a project with due dates and completion.

portfolio items1
  • List portfolio itemsSource

    Projects and nested portfolios in a portfolio.

portfolios2
  • Get portfolioSource

    One portfolio with owner, dates and current status.

  • List portfoliosSource

    Portfolios in the workspace owned by the token's user (or a given owner for service accounts).

project custom fields1
  • List project custom fieldsSource

    Custom fields attached to a project, with types and enum options.

projects4
  • Create projectDestinationNot retried automaticallyApproval before production

    Creates a project in the configured workspace. Sharing, privacy and membership are left at Asana's defaults.

  • Get projectSource

    One project with owner, team, dates and current status.

  • List projectsSource

    Active projects in the configured workspace.

  • Update projectDestinationProvider duplicate protectionApproval before production

    Updates a project's name, notes, color, view, dates or archived state.

section tasks1
  • List section tasksSource

    Tasks in a section (board column), optionally only incomplete or recently completed.

sections3
  • Create sectionDestinationNot retried automaticallyApproval before production

    Creates a section (board column) in a project.

  • List project sectionsSource

    Sections (board columns) in a project.

  • Rename sectionDestinationProvider duplicate protectionApproval before production

    Renames a section.

status updates3
  • Post status updateDestinationNot retried automaticallyApproval before production

    Posts a status update on a project, portfolio or goal.

  • Get status updateSource

    One status update.

  • List status updatesSourceIncremental

    Status updates on a project, portfolio or goal, optionally only recent ones.

stories1
  • List task storiesSourceIncremental

    The full activity history of a task, including comments and system changes such as assignment and completion.

subtasks1
  • List subtasksSource

    Direct subtasks of a task.

tags4
  • Create tagDestinationNot retried automaticallyApproval before production

    Creates a tag in the configured workspace.

  • Get tagSource

    One tag.

  • List tagsSource

    Tags in the configured workspace.

  • Update tagDestinationProvider duplicate protectionApproval before production

    Renames or recolours a tag.

task projects1
  • Add task to projectDestinationProvider duplicate protectionApproval before production

    Adds a task to another project, optionally in a section. A task already in the project moves to the section.

task tags1
  • Add tag to taskDestinationProvider duplicate protectionApproval before production

    Adds an existing tag to a task.

tasks5
  • Create task or subtaskDestinationNot retried automaticallyApproval before production

    Creates a task in a project, or a subtask when a parent task is supplied.

  • Get taskSource

    One task with projects, sections, tags, dependencies, dependents and custom fields.

  • List project tasksSourceIncremental

    Tasks in a project with assignees, dates, dependencies and custom fields.

  • Search tasksSourceIncremental

    Searches tasks in the workspace with validated filters on text, people, projects, sections, tags, dates and state.

  • Update taskDestinationProvider duplicate protectionApproval before production

    Updates supplied fields on a task.

teams2
  • Get teamSource

    One team.

  • List teamsSource

    Teams in the configured organisation.

time entries5
  • Log time on taskDestinationNot retried automaticallyApproval before production

    Creates a time tracking entry on a task.

  • Get time tracking entrySource

    One time tracking entry.

  • List time tracking entriesSource

    Actual time logged on a task.

  • Search time tracking entriesSource

    Time entries across the workspace by entry date, optionally for a user, project or portfolio, for timesheet and billing exports.

  • Update time tracking entryDestinationProvider duplicate protectionApproval before production

    Changes the duration, date, attributed project or billable status of an entry.

users2
  • Get userSource

    One user by GID.

  • List workspace usersSource

    Users in the workspace for assignee mapping.

workspaces2
  • Get workspaceSource

    The configured workspace, or another by GID.

  • List workspacesSource

    Workspaces and organisations the token can access.

Access and limits

Authentication
Personal access token or service account token
Plans and access
All plans; custom fields, dependencies and search need paid plans; portfolios, goals and time tracking need Business or Enterprise features. Access follows the user or service account that owns the token. Service accounts need Enterprise.
Test environment
Use a free or trial workspace for testing; Asana has no separate sandbox.
Rate limits
150 requests per minute on free plans and 1,500 on paid plans, plus concurrency and cost limits; HTTP 429 with Retry-After.
Pagination
Opaque offset tokens with up to 100 records per page; sync tokens for events; task search returns a single page.
Provider events
Asana webhooks with X-Hook-Signature HMAC-SHA256. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.

Before you build a flow

  • Asana has no idempotency key for creates; uncertain creates are not repeated automatically.
  • Attachment metadata is read; file contents are not transferred or uploaded.
  • Task search does not paginate and needs a premium workspace or team.
  • The first events sync token is only returned in a 412 response, which the runtime reports as an error; supply an initial token and chain nextSyncToken.
  • Deletes, removing dependencies, tags, projects or followers, follower and membership changes, project privacy and sharing, project duplication and templates, workspace and team membership, and portfolio membership changes are intentionally excluded.
  • The project team field is deprecated by Asana for sharing; Nexra only passes it on creation where organisations require it.

Developer reference

  1. Create the Asana, Inc. credentials described above with the narrowest permissions your flows need.
  2. In Nexra, open Connect, then Connections, then New connection, choose Asana, enter its settings and credentials, and tick only the write actions you need. Connection guide
  3. Test the connection, then use its actions as flow sources and destinations. Flow guide
Asana, Inc. docsAPI referenceAsana, Inc. docsAuthenticationAsana, Inc. docsRate limitsAsana, Inc. docsWebhooks

Machine-readable detail: GET /api/public/connect/connectors/asana and the Connections API.