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

# Trello

> Trello provider is a provider used to query data from Trello

## Authentication

This provider requires authentication.

* **api\_key**: Trello API Key (required: True, sensitive: True)
* **api\_token**: Trello API Token (required: True, sensitive: True)

## In workflows

This provider can be used in workflows.

As "step" to query data, example:

```yaml theme={null}
steps:
    - name: Query trello
      provider: trello
      config: "{{ provider.my_provider_name }}"
      with:
        board_id: {value}  # Trello board ID
        filter: {value}  # Trello action filter
```

Check the following workflow example:

* [notify-new-trello-card.yml](https://github.com/keephq/keep/blob/main/examples/workflows/notify-new-trello-card.yml)

## Connecting with the Provider

1. Go to [https://trello.com/power-ups/admin](https://trello.com/power-ups/admin) to create custom power-up.
2. Create new power-up and add basic details like name, email address, etc.
3. Once it is created, navigate inside power-up and go to API Key section.
4. There click on `Generate a new API key` and it will generate API Key, that will be used as `api_key`.
5. For generating `api_token`, there is option to generate Token manually, click on that and authorize the application.

## Notes

## Useful Links

* [https://developer.atlassian.com/cloud/trello/guides/power-ups/your-first-power-up/](https://developer.atlassian.com/cloud/trello/guides/power-ups/your-first-power-up/)
* [https://trello.com/power-ups/admin](https://trello.com/power-ups/admin)