Discover

Get Started

Developers

Industries

Integrate Atlassian Trello Notifications

Overview

You can integrate Atlassian Trello notifications to automatically create Trello cards for file transfer events.

Once the integration is complete, a new card is automatically created in the specified Trello list whenever selected events occur, such as Started, Completed, or Failed.

The setup consists of three steps:

① Generate an API Key and Token → ② Obtain the target List ID → ③ Configure notification settings in the product

Prerequisites

Before you begin, verify the following requirements.

ItemDescription
Trello AccountA Trello account with permission to create Power-Ups (Apps) is required.
Target Board / ListPrepare the Trello board and list where cards will be created.
NetworkThe environment where the product is installed must allow outbound HTTPS (443) access to api.trello.com.

Generate a Trello API Key and Token

A Trello API Key is associated with a Power-Up (App).

First, create a Power-Up, then generate an API Key and Token.

Step 1. Create a Power-Up

Go to:

https://trello.com/power-ups/admin

Click New.

Enter the required information, such as the Power-Up name, and click Create.

7_1

Step 2. Generate an API Key

Open the API Key tab for the Power-Up you created.

Select Generate a new API Key.

Copy the generated API Key.

The Secret displayed on the same page is used only for OAuth 1.0 authentication and is not required for this integration.

7_2

Step 3. Generate a Token

Click the Token link next to the API Key.

When the authorization page appears, click Allow, then copy the generated Token.

The API Key identifies your application, while the Token grants access to your Trello account. Treat the Token like a password and store it securely.

If the Token is compromised, it can be revoked at any time from your Trello account settings.

7_3

Verification

  • ✔ A Power-Up has been created.
  • ✔ The API Key has been copied.
  • ✔ The Token has been copied.

Obtain the Target List ID

Find the ID of the Trello list where cards will be created.

Step 1. Find the List ID from the Board JSON

Open the target board in your browser.

Append .json to the end of the board URL.

text
1
https://trello.com/b/<boardId>.json

Locate the target list in the JSON data and note its id value.

7_4

Step 2. Find the List ID Using the API (Optional)

You can also retrieve list information using the API with the API Key and Token generated in the "Generate a Trello API Key and Token" section.

text
1
https://api.trello.com/1/boards/<boardId>/lists?key=<API Key>&token=<Token>

Locate the target list in the response and copy its id.

7_5

Verification

  • ✔ The target List ID has been identified.

Configure Trello Notifications

Enter the API Key, Token, and List ID into the product notification settings.

Open the Notifications settings page.

7_6

Step 1. Enter the API Key

Enter the API Key copied in the "Generate a Trello API Key and Token" section into the API Key field.

Step 2. Enter the Token

Enter the Token copied in the "Generate a Trello API Key and Token" section into the Token field.

Step 3. Enter the List ID

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

Step 4. Select Notification Events

Select the events that should trigger Trello card creation.

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

EventTrigger
StartedWhen a file transfer starts
CompletedWhen a file transfer completes successfully
PausedWhen a transfer is paused
ResumedWhen a paused transfer resumes
RecoveredWhen a transfer automatically recovers after an interruption or error
CanceledWhen a transfer is canceled by the user
FailedWhen a transfer fails
SkippedWhen a file is skipped (for example, because it already exists or matches a filter rule)

Step 5. Save the Configuration

Click Add to save the integration.

Verification

  • ✔ The API Key and Token have been entered.
  • ✔ The List 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.

7_7

Step 2. Check the Trello List

Confirm that a new card has been created in the specified Trello list.

7_8

Verification

  • ✔ A new card has been created in the Trello list.
  • ✔ The event information has been recorded correctly.

Configuration Complete

Once the configuration is saved, the integration becomes active.

From this point forward, a new Trello card is automatically created in the specified list whenever one of the selected events occurs.

Troubleshooting

If cards are not created, verify the following items.

IssueCheck
Card is not createdVerify that the API Key, Token, and List ID have been entered correctly.
Permission errorVerify that the Token was generated from an account with access to the target board and permission to create cards.
List not foundVerify that the List ID belongs to the target list, not a board ID or card ID.
Token does not workVerify that the Token has not been revoked or expired. Generate a new Token if necessary.
Notification delivery fails in a restricted networkEnsure that outbound HTTPS (443) access to api.trello.com is allowed through the firewall or proxy.