AtlasWork, planned itself.

The AI-native, all-in-one work platform. Tasks, projects, CRM, contracts, and analytics in one calm workspace.

All systems operational
  • SOC 2 II
  • ISO 27001
  • HIPAA
  • GDPR

Product

  • Overview
  • PDF tools
  • Diagram tools
  • People & HR
  • Integrations
  • Marketplace
  • Pricing

Resources

  • Guides
  • Glossary
  • Compare
  • Docs
  • API reference
  • Support
  • Changelog
  • Status

Company

  • About
  • Careers
  • Press
  • Contact

Legal & trust

  • Trust center
  • Security
  • Privacy
  • Terms
  • DPA
  • GDPR
  • SLA
  • Refunds
  • Google API data
Atlas, a product by wrxstack.com·© 2026 wrxstack·All rights reserved
PrivacyTermsSecurityStatus
Skip to documentation
Docs
Back to Atlas

Start here

  • Overview

Developer

  • REST API guide
  • Authentication
  • API reference
  • MCP (AI agents)
  • SDKs
  • Quick actions

Webhooks

  • Overview
  • Quickstart
  • Events
  • Payloads and headers
  • Security and signing
  • Delivery and retries
  • Managing via API

Connect

  • Connectors
  • Integrations

Product

  • Collaboration and chat

Reference

  • Glossary
  • Keyboard shortcuts
  • Module reference
Asana logo

Work management

Asana

Connect Asana so projects, sections, and tasks sync with Atlas project intelligence.

AuthOAuth 2.0UpdatesReal-timeAvailable

What this connector does

  • Sync Asana workspaces, teams, projects, and tasks into Atlas.
  • Reflect status and assignee changes both directions after mapping approval.
  • Convert Asana tasks into Atlas tasks without copying private notes.
  • Listen for change events through Asana webhooks.

Before you begin

  • You are an organization admin on Asana.
  • OAuth apps are allowed for your organization.
  • You have a sandbox project for first validation.

Get your credentials

1

Open Asana developer console

Sign in with the admin account. asana.com developer console

2

Create a new app

Click Create New App, name it Atlas Connector.

3

Add the Atlas redirect URL

Set Redirect URL to https://YOUR-ATLAS-HOST/oauth/callback/asana.

4

Add scopes

Pick the default scope set. Asana uses a single default scope and per-endpoint permissions.

5

Copy the client id and secret

Copy Client ID and Client Secret into the Atlas Asana connector settings page.

Required scopes and permissions

Default OAuth scopedefault
Refresh accessoffline_access

Setup checklist

  1. Create the provider app in a sandbox or development workspace.
  2. Add the Atlas redirect URL to the provider app configuration.
  3. Copy the client id, client secret, or API key.
  4. Paste the credentials into the Atlas connector settings page.
  5. Click Connect and complete the provider sign-in screen.
  6. Run Test connection from the connector page to verify health.

Troubleshooting

  • invalid_grant

    Refresh token expired or was revoked. Reconnect from Atlas.

  • forbidden

    The connected user is not a member of the project. Add them or use a workspace-wide service account.

  • webhook handshake failed

    Asana requires the receiver to echo X-Hook-Secret on registration. Atlas handles this only if the endpoint is reachable.

Webhooks

Atlas registers Asana webhooks per project and validates the X-Hook-Signature header on every event.

Events Atlas listens for

  • Task created
  • Task changed
  • Task deleted
  • Story added

Provider docs: https://developers.asana.com/docs/webhooks

Disconnect and data deletion

  1. Click Disconnect on the Atlas Asana connector page.
  2. Open developer console, Apps, and revoke the Atlas Connector OAuth grant.
  3. Atlas removes cached Asana data within 24 hours of disconnect.

Once you have the credentials above, paste them into the live connector page to finish connecting Asana.

Open the Asana connector page

On this page

  • What this connector does
  • Before you begin
  • Get your credentials
  • Required scopes and permissions
  • Setup checklist
  • Troubleshooting
  • Webhooks
  • Disconnect and data deletion