Skip to main content

Asana

Available

This integration is active and ready to use in Frihet.

Connect your Asana workspace to Frihet. View projects and tasks directly from your ERP to have visibility of work completed when invoicing.

What is it for?​

With Asana integrated:

  • View projects — View all your Asana projects from Frihet
  • View tasks — Browse tasks for each project with their status
  • Context for invoicing — Review completed tasks before creating invoices
  • Automatic workspace detection — Frihet automatically detects your primary workspace

Requirements​

  • Active Asana account — asana.com
  • Personal Access Token — Generated from Asana settings
  • Frihet Pro or higher

Connect Asana with Frihet​

Step 1: Get your Personal Access Token​

  1. Go to app.asana.com/0/developer-console
  2. Log in with your Asana account
  3. In the Personal access tokens section, click on Create new token
  4. Give it a name (e.g., "Frihet ERP")
  5. Accept the API terms
  6. Copy the generated token
Save the token

The Personal Access Token is only shown once. Copy it before closing the window.

Step 2: Configure in Frihet​

  1. Go to Settings → Integrations
  2. Search for Asana
  3. Click on Connect
  4. Paste your Personal Access Token
  5. Click on Verify connection
  6. Frihet will automatically detect your first workspace

Step 3: Verify connection​

If the connection is successful, Frihet will show:

  • Name of your Asana workspace
  • Number of accessible projects
  • Your Asana username

How it works​

Frihet uses the Asana REST API v1 with Bearer authentication:

  1. You provide your Personal Access Token
  2. Frihet sends the token in the Authorization: Bearer <token> header
  3. Upon connecting, Frihet queries your workspaces and automatically selects the first one
  4. Projects and tasks are queried on demand
  5. The token is stored encrypted (AES-256-GCM) in Frihet

Synchronized data​

DataDirectionFrequency
ProjectsAsana → FrihetOn demand
TasksAsana → FrihetOn demand
Task statusAsana → FrihetWith each query
AssigneesAsana → FrihetWith each query

Use cases​

Consultant who invoices per project​

You manage each client's deliverables in Asana. Before invoicing, you query completed tasks for the project from Frihet to include the correct breakdown in the invoice.

Creative agency with sprints​

Your team works in sprints organized into Asana projects. At the end of each sprint, you query completed tasks from Frihet and generate the corresponding invoices.

Verify scope before invoicing​

You have a project with a defined scope in Asana. Before issuing the final invoice, you verify from Frihet that all scope tasks are marked as completed.

Features​

View projects​

  1. From Frihet, access the Asana section
  2. You will see all projects in your workspace
  3. Each project shows name, status, and number of tasks

View project tasks​

  1. Select a project
  2. Frihet displays tasks with:
    • Task name
    • Status (completed / pending)
    • Assigned person
    • Due date
  3. Filter by status to see only completed tasks

Automatic workspace detection​

Upon connecting, Frihet automatically detects your first workspace. If you have multiple Asana workspaces, the primary one is used. You don't need to configure anything additional.

Error handling​

All calls to the Asana API have a 30-second timeout. If a request fails, Frihet automatically logs the error for diagnosis. Check your internet connection if queries repeatedly fail.

Troubleshooting​

"Authentication error"​

  • Verify that the Personal Access Token is correct
  • Check that it has not been revoked in the Asana developer console
  • If you regenerated the token, update it in Frihet

"I don't see my projects"​

  • Frihet uses the first workspace of your account. If you have several, the one you want might be in another
  • Verify that you have access to the projects from your Asana account
  • Private projects of other users will not be visible

"Tasks are not updating"​

  • Queries are real-time (on demand)
  • Reload the view in Frihet to see recent changes
  • Verify that tasks are assigned to the correct project in Asana

"I want to use another workspace"​

  • Currently, Frihet auto-detects the first workspace
  • If you need to change, disconnect and reconnect the integration
  • The selected workspace depends on the order returned by the Asana API

"I want to disconnect"​

  1. Go to Settings → Integrations → Asana
  2. Click on Disconnect
  3. Optionally, revoke the token at app.asana.com/0/developer-console

Next steps​