Skip to main content
When incidents happen, keeping everyone organized matters. OpenSRE connects to Trello so you can create incident cards, track investigation progress, and manage follow-up tasks — all without leaving your incident response workflow.

​
What you need

  • A Trello account with access to the boards you want OpenSRE to use
  • A Trello API key and token
  • Optional board and list IDs for automatic card creation

​
Setting up Trello

​
Quick setup

opensre integrations setup
Choose Trello and enter your API key and token when prompted.

​
Manual config: Environment variables

Or add these to your .env: 
TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token
TRELLO_BOARD_ID=board_id_optional
TRELLO_LIST_ID=list_id_optional
TRELLO_BASE_URL=https://api.trello.com/1
VariableDefaultDescription
TRELLO_API_KEY—Required. Trello API key
TRELLO_TOKEN—Required. Trello API token
TRELLO_BOARD_ID(empty)Optional default board ID for card creation
TRELLO_LIST_ID(empty)Optional default list ID for card creation
TRELLO_BASE_URLhttps://api.trello.com/1Trello API base URL

​
Persistent store

You can also save your Trello configuration to ~/.opensre/integrations.json: 
{
  "version": 1,
  "integrations": [
    {
      "id": "trello-prod",
      "service": "trello",
      "status": "active",
      "credentials": {
        "api_key": "your_api_key",
        "token": "your_token",
        "board_id": "board_id_optional",
        "list_id": "list_id_optional"
      }
    }
  ]
}

​
Getting your API key and token

  1. Visit https://trello.com/app-key
  2. Copy your Trello API key
  3. Generate a token from the same page
  4. Authorize access when prompted
  5. Store both values securely

​
Optional: Finding board and list IDs

If you’d like OpenSRE to create cards in a specific location, you’ll need the board and list IDs.

​
Using the API

curl "https://api.trello.com/1/members/me/boards?key=${TRELLO_API_KEY}&token=${TRELLO_TOKEN}"

​
Manual method

  1. Open the board in Trello
  2. Append .json to the board URL
  3. Search the response for the board ID
  4. Locate the desired list and copy its ID

​
Token longevity

Trello tokens can be created with different expiration periods. When generating a token, choose an expiration period that aligns with your organization’s security requirements. For long-lived OpenSRE integrations, consider using an appropriately scoped token and rotating it regularly according to your security policies.

​
Required permissions

Your Trello token should have:
  • read — Allows OpenSRE to view boards, lists, and cards
  • write — Allows OpenSRE to create or update cards during investigations

​
Usage

Once configured, OpenSRE can:
  • Create Trello cards from investigation findings
  • Send incident titles and descriptions to a target list
  • Track follow-up tasks on your incident board
Set TRELLO_LIST_ID to the list where new cards should appear. If omitted, card creation requires the list ID at investigation time.
Trello does not currently support opensre integrations verify trello. Confirm your credentials during interactive setup or by creating a test card from an investigation.