> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trello

> Connect Trello to Iru Compliance with a Power-Up API key and user token to collect read-only access to boards, lists, cards, and workspace membership evidence.

### About Trello

Trello’s REST API expects **`key`** (application id from **Power-Ups admin**) and **`token`** (user-authorized) on requests (for example **`GET /1/members/me/boards?key=…&token=…`**). The **key** is shareable; the **token** is secret and scopes access to what the authorizing user can see.

### How It Works

Iru authenticates to Trello’s REST API with your **Power-Up API key** and a **user token**, passed as **`key`** and **`token`** query parameters on each request (for example **`GET https://api.trello.com/1/members/me/boards?key=…&token=…`**).

| Detail             | Value                              |
| ------------------ | ---------------------------------- |
| **Category**       | Work management                    |
| **Authentication** | API key + token (query parameters) |

Create or open a **Power-Up** at **`https://trello.com/power-ups/admin`**, open the **API key** tab, **generate** a key, then visit Trello’s **authorize** URL with **`scope=read`** and your key to mint a **token**.

Official references: [Authorization](https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/), [API introduction](https://developer.atlassian.com/cloud/trello/guides/rest-api/api-introduction/), [Power-Up admin](https://trello.com/power-ups/admin).

### Prerequisites

* Trello user who can access the **boards** and **workspaces** you need for audits.

### Connect Trello to Iru

<Tabs>
  <Tab title="Trello">
    <Note>
      Complete this tab before you connect the source in Compliance.
    </Note>

    <Steps>
      <Step title="Sign in to Trello">
        Open [Trello](https://trello.com) and sign in with a user who can access the **boards** and **workspaces** Iru should read.
      </Step>

      <Step title="Open Power-Up admin">
        Go to **`https://trello.com/power-ups/admin`** (Trello Power-Up administration) for your account.
      </Step>

      <Step title="Create or select a Power-Up">
        Create a new Power-Up (or open an existing one) that you will use only to mint API credentials for Iru. Name it clearly (for example **Iru Compliance**).
      </Step>

      <Step title="Generate an API key">
        Open the **API key** tab for that Power-Up and **generate** an API **key** (`key`). Copy the key value; you will enter it in Iru as the **`key`** parameter.
      </Step>

      <Step title="Authorize a read-only token">
        Open Trello’s **authorize** URL documented for Power-Ups, including **`expiration`**, **`scope=read`**, **`response_type=token`**, and **`key=YOUR_API_KEY`**. Approve access when Trello prompts you.
      </Step>

      <Step title="Copy the user token">
        After you click **Allow**, Trello returns a **token** string. Copy it immediately; you will pair it with **`key`** in Iru.
      </Step>
    </Steps>

    <Note>
      Continue on the [**Iru Compliance**](#iru-compliance) tab.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**Trello**](#trello) tab first.
    </Note>

    <Steps>
      <Step title="Open Sources">
        In Iru Compliance, on the left navigation bar, expand **Compliance** and select **Sources**.

        <Frame>
          <img src="https://mintcdn.com/iru/7HsGH7lnQ8GpVmI0/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=7HsGH7lnQ8GpVmI0&q=85&s=595982441fd777b333b3ecfea24adc24" alt="Left navigation: Compliance expanded, Sources selected" width="424" height="1056" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Turn on Trello">
        Find **Trello** (use **Category** or **Search by name or description**). On that card, turn on the **toggle**. A browser tab or window may open for the connector wizard.
      </Step>

      <Step title="Enter API key and token">
        Provide **`key`** and **`token`** as the wizard shows (one screen or separate fields).
      </Step>

      <Step title="Finish the connection">
        Click **Submit API Key**. When the connection succeeds, the wizard shows **Connection Configured**.
      </Step>

      <Step title="Confirm the source is Active">
        Close the **Iru is requesting access to external services** browser tab, then return to **Compliance** → **Sources** and confirm the **Trello** card is **Active**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing opens when you turn the source on">
    Check **pop-up blocker** settings for the Iru site and try again.
  </Accordion>

  <Accordion title="401">
    Regenerate token; confirm key still valid.
  </Accordion>

  <Accordion title="429">
    Rate limits - retries may spread sync.
  </Accordion>

  <Accordion title="Missing boards">
    Token user must **join** those boards/workspaces.
  </Accordion>
</AccordionGroup>

### Related Articles

<CardGroup cols={2}>
  <Card title="Sources Management" icon="plug" href="/en/compliance/sources-management">
    Browse and manage every Compliance source.
  </Card>

  <Card title="Getting Started With Compliance" icon="rocket" href="/en/compliance/getting-started-with-compliance">
    Frameworks, actions, and **Artifacts**.
  </Card>

  <Card title="Iru Overview" icon="layer-group" href="/en/iru/platform-overview/iru-overview">
    How Endpoint, Compliance, and Identity fit together.
  </Card>

  <Card title="Artifacts Management" icon="folder-open" href="/en/compliance/artifacts-management">
    Upload, review, and organize evidence from sources and actions.
  </Card>
</CardGroup>