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.
| Item | Description |
|---|---|
| Asana Account | An Asana account with access to the target project is required. The Personal Access Token uses the permissions of the account that generated it. |
| Target Project | Prepare the Asana project where tasks will be created. |
| Network | Outbound HTTPS communication to app.asana.com (443) must be allowed from the environment where the product is installed. |
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.
| Event | When It Occurs |
|---|---|
| Started | When a transfer job starts |
| Completed | When a transfer completes successfully |
| Paused | When a transfer is paused |
| Resumed | When a paused transfer resumes |
| Recovered | When a transfer automatically recovers and resumes after an interruption or error |
| Canceled | When a user cancels a transfer |
| Failed | When a transfer fails |
| Skipped | When a specific file is skipped (for example, because it already exists or matches a filter condition) |
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.
| Problem | What to Check |
|---|---|
| Task is not created | Verify that the Personal Access Token and Project ID are entered correctly. |
| Authentication error (401) occurs | Verify that the token is valid and has not been deauthorized or reset. |
| Permission error occurs | Verify that the account that generated the token has permission to create tasks in the target project. |
| Project cannot be found | Verify that the Project ID is the correct numeric ID for the target project. |
| Integration fails in a closed network | Verify that outbound HTTPS communication to app.asana.com (443) is allowed through the firewall or proxy. |