As part of Simpplr's app tiles feature, we offer several out-of-the-box app tiles your org can set up on home and site dashboards. The article linked below gives an overview of how app tiles work, permissions around setting them up, and various requirements. 

Setting Up Out-of-the-Box App Tiles on Dashboards

This article explains the Asana tile.

Asana tile

Display team goals from Asana tile

This tile allows end users to view their team’s goals from their Asana account directly on the dashboard.

• Displays:
  • Time period
  • Goal name
  • Goal URL
  • Goal owner name
  • Status
  • Completion percentage
    
• Required inputs:
  • Workspace ID
  • Team ID
• Prerequisites & additional setup:
  • Users must authenticate with their Asana account

Display recently updated tasks from Asana tile

This tile allows end users to view and mark complete their recently updated tasks from their Asana account.

• Displays:
  • Task name
  • Task URL
  • Last updated date
  • Task status: either 'Completed' or a 'Mark complete' button if the task is pending
    • Ordering of tasks is based upon which tasks have been recently updated
• Interactions:
  • Clickable task name: redirects to the detailed task view in Asana.
  • Mark complete action: lets users mark tasks complete directly from the tile
  • Pagination: Display up to 4 tasks with a "Show more" link for additional items
• Parameters:
  • Workspace ID
  • Status: Pending, Completed
• Prerequisites & Setup:
  • An OAuth 2.0 Auth Code configuration is required. An OAuth app must be created by an Asana Admin to obtain the Client ID and Client Secret. Refer to the Asana developer documentation for details on creating an OAuth app and configuring the necessary scopes
  • An app must must have enabled and configured the Asana integration from Manage > Application > Integrations > Custom apps
  • Navigate to Add new app > Add prebuilt app, then select and add the Asana app.
  • Once added, configure the app using the generated Client ID and Client Secret. The Auth URL, Token URL, token headers, and Base URL will be pre-set
  • After completing the configuration, enable the app. Once enabled, the app will be available under the Add tile option on the home or site dashboard
  • Users must authenticate using their Asana accounts

Note: This tile returns the tasks assigned to the user based on their Asana account connected at user-level.

Configuring Asana OAuth Scopes for Simpplr Integration

Asana made changes to its OAuth scope system starting July 2025. Prior to this update, Asana used a single default scope with full permissions across all APIs. This default scope did not need to be included in the authorization URL. However, with the July 2025 update, Asana now offers explicit scope definitions for each resource when registering new OAuth applications, with the option for backward compatibility (via "Full permissions").

This document outlines how existing and new Simpplr customers should configure their Asana OAuth apps to ensure continued compatibility, especially when using Prebuilt Asana App Tiles in Simpplr.

For Customers Who Registered Asana OAuth Apps Before July 2025

• Asana automatically granted these apps "Full permissions", even though no scope was explicitly defined.
• These apps will continue to work without any changes.
• The Auth URL for such apps does not require a scope parameter.
• Example:

https://app.asana.com/-/oauth_authorize

For Customers Creating OAuth Apps After July 2025

You now have two options when registering your Asana OAuth app:

1. Use "Full Permissions"

• Select Full permissions while registering your Asana OAuth app.
• This mirrors the behavior of pre-July 2025 apps.
• You do not need to include scopes in the Auth URL.
• Example:

https://app.asana.com/-/oauth_authorize

2. Use specific scopes for prebuilt Asana app tiles

To use prebuilt Asana app tiles, select and specify the following scopes during OAuth app registration:

Required Scopes:

• tasks:read
• tasks:write
• users:read
• goals:read

These scopes must be included in the scope parameter of your Auth URL, separated by %20 (URL-encoded space).

• Example Auth URL:

  https://app.asana.com/-/oauth_authorize?scope=tasks:read%20tasks:write%20users:read%20goals:read

Check the full list of list of Asana reference scopes here.