​
Setup Guide

You’ll need the following information to set up your Trello App with Paragon Connect:
  • API Key
  • API Secret
  • Scopes Requested

​
Generate a Trello API Key and API Secret

  1. Log in to Trello. If you don’t have an account, you can create one here.
  2. Access the Power-Up Admin Portal. If you haven’t created a Power-Up yet, click on “New” to create one.
  3. Within your Power-Up’s settings, go to the API Key tab.
  4. Your API Secret will be displayed in the same section.

​
Add your Trello app to Paragon

  1. Select Trello from the Integrations Catalog.
  2. Under Integrations > Connected Integrations > Trello > Settings, fill out your credentials in their respective sections:
  • API Key: Found under API Key > API Key.
  • API Secret: Found under API Key > API Secret.
  • Permissions: Select the scopes you’ve requested for your application. For a list of recommended scopes, please view this integration within your Paragon dashboard. View dashboard.
Press the purple “Save Changes” button to save your credentials.
Note: Leaving the API Key and API Secret blank will use Paragon development keys.

​
Connecting to Trello

Once your users have connected their Trello account, you can use the Paragon SDK to access the Trello API on behalf of connected users. See the Trello REST API documentation for their full API reference. Any Trello API endpoints can be accessed with the Paragon SDK as shown in this example
JavaScript
// You can find your project ID in the Overview tab of any Integration.

// Authenticate the user
paragon.authenticate(<ProjectID>, <Paragon User Token>);

// Get a board
await paragon.request("trello", "/boards/<Board ID>", {
  method: “GET”,
});

// Create a new card
await paragon.request("trello", "/cards",
  method: “POST”,
  body: {
    idList: “<List ID>”,
    name: “New task”,
    desc: “Integrate all productivity apps using Paragon”
  }
});

​
Building Trello workflows

Once your Trello account is connected, you can add steps to perform the following actions:
  • Search Cards
  • Get Cards in Board
  • Create Card
  • Update Card
  • Delete Card
  • Get Lists in Board
  • Search Boards
When using Trello, you can reference data from previous steps by typing {{ to invoke the variable menu.

​
Using Webhook Triggers

Webhook triggers can be used to run workflows based on events in your users’ Trello account. For example, you might want to trigger a workflow whenever Cards are updated to sync your users’ Trello Cards to your application in real-time.
You can find the full list of Webhook Triggers for Trello below:
  • Board Created
  • Board Updated
  • Card Created
  • Card Updated
  • New Comment