Overview#
You can integrate Atlassian Trello notifications to automatically create Trello cards for status changes during file transfer tasks.
After completing the integration, a card is automatically created in the designated Trello list whenever designated events occur, such as a transfer being Started, Completed, or Failed.
The entire process proceeds in the following order: ① Obtain an API Key / Token → ② Check the target List ID → ③ Configure notifications in the product.
Prerequisites#
Before you begin, check the following.
| Item | Description |
|---|---|
| Trello account | A Trello account with permission to create a Power-Up(App) is required. |
| Target board/list | Prepare the Trello board and list where cards will be created in advance. |
| Network | Outbound HTTPS communication to api.trello.com (443) must be allowed from the environment where the product is installed. |
Obtain a Trello API Key / Token#
A Trello API Key is issued in connection with a Power-Up(App).
First, create a Power-Up, then obtain an API Key and Token.
Step 1. Create a Power-Up#
https://trello.com/power-ups/admin 에 접속한 후 New를 클릭합니다.
Enter the required information, such as the Power-Up name, then click Create to create the Power-Up.
Step 2. Obtain an API Key#
In the API Key tab of the Power-Up you created, select Generate a new API Key.
Copy the generated API Key.
ℹ️ The Secret displayed on the same screen is used for OAuth 1.0 authentication and is not required for this integration.
Step 3. Obtain a Token#
Click the Token link next to the API Key.
When the permission request screen appears, select Allow, then copy the issued Token.
ℹ️ The API Key identifies the application, while the Token has permission to access the account, so it must be managed securely like a password. If the Token is exposed, it can be revoked at any time in the Trello account settings.
Checklist#
- ✔ The Power-Up has been created.
- ✔ The API Key has been copied.
- ✔ The Token has been copied.
Check the Target List ID#
Check the ID of the target list where cards will be created.
Step 1. Check from the Board JSON#
Open the target board in a browser, then add .json to the end of the address and open it again.
https://trello.com/b/<boardId>.jsonFind the desired list in the displayed JSON data and check the id value of that item.
Step 2. Check via API (Optional)#
Using the issued API Key and Token, you can retrieve list information through the API below.
https://api.trello.com/1/boards/<boardId>/lists?key=<API Key>&token=<Token>Check the id value of the target list in the response.
Checklist#
- ✔ The List ID of the target list has been confirmed.
Trello Notification Settings#
Enter the issued API Key, Token, and List ID in the product's notification settings.
When you open the Notifications settings window, the following screen is displayed.
Step 1. Enter the API Key#
Enter the copied API Key in the API Key field.
Step 2. Enter the Token#
Enter the copied Token in the Token field.
Step 3. Enter the List ID#
Enter the confirmed List ID in the List ID field.
Step 4. Select Notification Events#
Select the events for which you want to receive notifications under Events.
You can select multiple events, and Trello cards are created only when the selected events occur.
| Event | When It Occurs |
|---|---|
| Started | When the transfer task starts |
| Completed | When the transfer is completed successfully |
| Paused | When the transfer is temporarily paused |
| Resumed | When a paused transfer starts again |
| Recovered | When the transfer is automatically recovered and resumed after an interruption or error |
| Canceled | When the user cancels the transfer |
| Failed | When the transfer fails |
| Skipped | When a specific file is skipped (Example: an existing file or a file matching a filter condition) |
Step 5. Save the Settings#
After completing the input, click Add to save the integration.
Checklist#
- ✔ The API Key and Token have been entered.
- ✔ The List ID has been entered.
- ✔ The events for which notifications will be received have been selected.
Verify the Integration#
Verify that the settings are working correctly.
Step 1. Trigger a Test Event#
Run an actual transfer task or trigger one of the selected events.
Step 2. Check the Trello List#
Check whether a new card has been created in the designated Trello list.
Checklist#
- ✔ A card has been created in the Trello list.
- ✔ The triggered event was recorded accurately.
Setup Complete#
Once the settings are saved, the integration is applied.
After that, a card is automatically created in the designated Trello list whenever the selected events occur.
Troubleshooting#
If cards are not created, check the following items.
| Issue | What to Check |
|---|---|
| A card is not created | Check whether the API Key, Token, and List ID were entered correctly. |
| A permission error occurs | Check whether the Token was issued from an account with access and write permission to the target board. |
| The list cannot be found | Check whether the List ID is the ID of the target list. (Not a board ID or card ID.) |
| The Token does not work | Check whether the Token has been revoked or expired, and issue a new one if necessary. |
| Integration fails in a closed network | Check whether outbound HTTPS communication to api.trello.com (443) is allowed by the firewall or proxy. |