Asana
Project management and team collaboration
Our Asana connection allows you to synchronize projects, tasks, and team collaboration between Asana and Circle+.
Task Management
Sync and manage tasks across platforms
Team Collaboration
Keep your team in sync with bidirectional updates
Real-time Sync
Automatic synchronization of project data
Prerequisites
Before you begin integrating Asana, make sure you have:
- An Asana account (sign up at asana.com if you don't have one)
- Admin access to your Circle+ account
- Access to the Asana workspace you want to connect
Installation
Step 1: Connect your Asana account
From your Circle+ desk, navigate to Plug & Play > Asana and click "Connect with Asana".
Step 2: Authorize access
You'll be redirected to Asana to authorize the connection. Review the permissions and click "Allow".
Step 3: Select workspace and projects
After connecting, you'll be returned to Circle+ where you can select which Asana workspace and projects to sync.
Authentication
The Asana connection uses OAuth 2.0 for secure authentication. This allows Circle+ to access your Asana data without storing your password.
OAuth Scopes
The connection requests the following permissions:
- Read and write access to tasks and projects
- Read access to teams and workspaces
- Read access to user information
Token Management
Your OAuth tokens are securely stored and automatically refreshed when needed. You can revoke access at any time by disconnecting the connection in your Circle+ desk or by removing the app from your Asana account settings.
If you suspect unauthorized access, immediately disconnect the connection and contact our support team.
Workspace Selection
After connecting your Asana account, you'll need to select which workspace to use with Circle+.
Selecting a workspace
In your connection settings, you'll see a list of all workspaces you have access to. Select the workspace you want to use with Circle+.
Multiple workspaces
If you need to connect multiple workspaces, you can add additional connections in your connection settings. Each workspace connection can have its own configuration.
Project Mapping
Map Asana projects to Circle+ projects for seamless task synchronization.
Selecting projects to sync
After selecting a workspace, you can choose which projects to sync:
- Sync all projects in the workspace
- Select specific projects to sync
- Exclude certain projects from syncing
Project mapping options
For each project, you can configure:
- Sync direction (one-way or bidirectional)
- Task status mapping
- Assignee mapping
- Custom field mapping
Task Management
Synchronize tasks between Asana and Circle+.
Create tasks in either Asana or Circle+ and have them automatically sync to the other platform.
Creating a task in Circle+
1. Navigate to the project in your Circle+ desk
2. Click "Add Task" and fill in the task details
3. The task will automatically sync to Asana during the next sync cycle
Project Sync
Keep your Asana projects in sync with Circle+.
Sync frequency
Configure how often your projects sync:
- Real-time (via webhooks)
- Every 15 minutes (default)
- Hourly
- Daily
- Manual sync only
Sync direction
Choose how changes are synchronized:
- Bidirectional (changes in either platform sync to the other)
- Asana to Circle+ only
- Circle+ to Asana only
Initial sync
When you first connect a project, you can choose to import existing tasks from Asana or start with a clean slate. If you import existing tasks, you can specify a date range to limit which tasks are imported.
Team Collaboration
Enhance team collaboration with synchronized comments, attachments, and assignments.
Comments and discussions
Comments added to tasks in either platform can be synchronized, allowing team members to collaborate regardless of which platform they're using.
Attachments
Files attached to tasks in Asana can be accessed in Circle+ and vice versa. Supported file types include images, documents, spreadsheets, and PDFs.
User mapping
Map Asana users to Circle+ users to ensure that task assignments and mentions are correctly synchronized between platforms.
Common Issues
Sync delays
If changes aren't syncing as expected, check your sync frequency settings and verify that the connection has the necessary permissions. You can also try triggering a manual sync from your connection settings.
Authentication errors
If you're experiencing authentication errors, try disconnecting and reconnecting the connection. This will refresh your OAuth tokens and ensure that the connection has the necessary permissions.
Missing tasks or projects
If tasks or projects are missing, check your project mapping settings to ensure that the correct projects are selected for syncing. Also verify that any filters or date ranges aren't excluding the missing items.
Error Messages
| Error Message | Description | Resolution |
|---|---|---|
| Authentication failed | The OAuth token is invalid or expired | Disconnect and reconnect the connection |
| Project not found | The Asana project no longer exists or is inaccessible | Check project permissions or select a different project |
| Rate limit exceeded | Too many API requests in a short period | Reduce sync frequency or optimize API usage |
| Sync conflict | Changes made to the same task in both platforms | Resolve the conflict manually in the connection settings |
Support
Circle+ Support
For issues related to the Asana connection with Circle+, contact our support team:
- Email: support@circleplus.io
- Support Portal: help.circleplus.io
Asana Support
For issues related to your Asana account or the Asana API, contact Asana support:
- Asana Help: asana.com/guide
- Asana Developer Documentation: developers.asana.com/docs