Integrate Asana Notifications

Overview

You can integrate Asana notifications to automatically create Asana tasks for file transfer events.

Once the integration is complete, a new task is automatically created in the specified Asana project whenever selected events occur, such as Started, Completed, or Failed.

The setup consists of three steps:

① Generate a Personal Access Token → ② Obtain the target Project ID → ③ Configure notification settings in the product

Prerequisites

Before you begin, verify the following requirements.

Generate a Personal Access Token (PAT)

To create tasks in Asana, you must generate a Personal Access Token (PAT) from the Asana Developer Console.

Step 1. Open the Developer Console

Click your profile picture and navigate to:

Settings → Apps → Build new apps → View developer console

Or open the following URL directly:

Step 2. Create a Token

Under Personal access tokens, select Create new token.

Enter a token name, accept the Asana API Terms, and click Create token.

Step 3. Copy the Token

Copy the generated Personal Access Token.

The token is displayed only once when it is created, so store it securely.

A PAT has the same permissions as the account that created it. Treat it like a password and never expose it publicly.

If the token is compromised, you can deactivate (deauthorize) it from the Developer Console.

Verification

• ✔ A Personal Access Token has been created in the Developer Console.
• ✔ The Personal Access Token has been copied and stored securely.

Obtain the Target Project ID

Identify the Project ID of the Asana project where tasks will be created.

Step 1. Find the Project ID from the Project URL

Open the target project.

The Project ID appears in the browser URL.

The numeric value immediately following /1/ is the Project ID.

Step 2. Find the Project ID Using API Explorer (Optional)

In the Developer Console, run GET /projects from the API Explorer.

The response contains the list of accessible projects and each project's project_gid.

Verification

• ✔ The target Project ID has been identified.

Configure Asana Notifications

Enter the Personal Access Token and Project ID into the product notification settings.

Open the Notifications settings page.

Step 1. Enter the Personal Access Token (PAT)

Enter the Personal Access Token copied in the "Generate a Personal Access Token (PAT)" section into the Personal Access Token (PAT) field.

Step 2. Enter the Project ID

Enter the Project ID identified in the "Obtain the Target Project ID" section into the Project ID field.

Step 3. Select Notification Events

Select the events that should trigger Asana task creation.

You can select multiple events. A task is created only when one of the selected events occurs.

Step 4. Save the Configuration

Click Add to save the integration.

Verification

• ✔ The Personal Access Token has been entered.
• ✔ The Project ID has been entered.
• ✔ The notification events have been selected.

Verify the Integration

Verify that the integration is working correctly.

Step 1. Trigger a Test Event

Start an actual file transfer or trigger one of the selected notification events.

Step 2. Check the Asana Project

Confirm that a new task has been created in the specified Asana project.

Verification

• ✔ A new task has been created in the Asana project.
• ✔ The event information has been recorded correctly.

Configuration Complete

Once the configuration is saved, the integration becomes active.

From this point forward, a new task is automatically created in the specified Asana project whenever one of the selected events occurs.

Troubleshooting

If tasks are not created, verify the following items.