Asana Notification Integration

Overview#

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

After the integration is complete, a task is automatically created in the specified Asana project whenever a selected event occurs, such as a transfer being Started, Completed, or Failed.

The entire process consists of three steps: ① Generate a Personal Access Token → ② Check the target Project ID → ③ Configure notifications in the product.

Prerequisites#

Before you begin, check the following.

Generate a Personal Access Token (PAT)#

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

Step 1. Open the Developer Console#

Click your profile picture, then select Settings → Apps → Build new apps → View developer console.

You can also access it directly at the address below.

https://app.asana.com/1/my-apps

Step 2. Create a Token#

From the Personal access tokens menu, select Create new token.

Enter a token name, agree to the Asana API terms, and click Create token.

Step 3. Copy the Token#

Copy the generated Personal Access Token.

ℹ️ This token can only be viewed once when it is created, so store it in a secure location. The PAT has the same permissions as the account that generated it, so treat it like a password and do not expose it externally. If it is exposed, you can deauthorize the token in the Developer Console.

Verification#

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

Check the Target Project ID#

Check the Project ID of the target project where tasks will be created.

Step 1. Check the Project URL#

When you open the target project, the Project ID is included in the URL in the browser address bar.

The number displayed after /1/ is the Project ID.

https://app.asana.com/1/<Project ID>/...

Step 2. Check in API Explorer (Optional)#

In the Developer Console's API Explorer, run GET /projects to view the accessible project list and each project's project_gid.

Verification#

• ✔ The target project's Project ID has been checked.

Configure Asana Notifications#

Enter the generated Personal Access Token and Project ID in the product's notification settings.

Open the Notifications settings window to display the screen below.

Step 1. Enter the Personal Access Token (PAT)#

Enter the copied token in the Personal Access Token (PAT) field.

Step 2. Enter the Project ID#

Enter the verified Project ID in the Project ID field.

Step 3. Select Notification Events#

Select the events you want to receive notifications for in the Events field.

You can select multiple events. Asana tasks are created only when the selected events occur.

Step 4. Save the Settings#

After entering the information, click Add to save the integration.

Verification#

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

Verify the Integration#

Verify that the configuration works correctly.

Step 1. Trigger a Test Event#

Run an actual transfer job or trigger one of the selected events.

Step 2. Check the Asana Project#

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

Verification#

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

Setup Complete#

The integration is applied when you save the settings.

Afterward, a task is automatically created in the specified Asana project whenever a selected event occurs.

Troubleshooting#

If a task is not created, check the following.