@devries-cameron20 / composio Mirror · read-only
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 06:00 UTC

next
md 45 lines 2.95 KB
Rendered Raw
1 ## How do I set up custom credentials for Trello?
2
3 Composio connects Trello with OAuth 1.0a. Use your own Trello API key and secret when you want the authorization screen to show your app name. Your Trello API key is the auth config's consumer key, and the Trello secret is its consumer secret.
4
5 ### Create the Trello Power-Up and API key
6
7 1. Sign in to Trello and open the [Power-Ups admin portal](https://trello.com/power-ups/admin). The old `https://trello.com/app-key` page redirects here.
8 2. Click **New** and fill in the form: an app name, any workspace you belong to, an email and support contact, an author, and an **Iframe connector URL**. A placeholder such as `https://example.com` works if you aren't building a Power-Up UI. Click **Create**.
9
10 ![Trello Power-Ups admin portal Your Apps page with the New button](/images/toolkits/trello/power-ups-admin.webp)
11
12 ![Trello New App form with app name, workspace, email, support contact, author, and Iframe connector URL](/images/toolkits/trello/new-app-form.webp)
13
14 3. Open the Power-Up, go to the **API Key** tab, and click **Generate a new API Key**.
15
16 ![Trello Power-Up API key tab with the Generate a new API Key button](/images/toolkits/trello/generate-api-key.webp)
17
18 4. Copy the **API Key**, then reveal and copy the **Secret**.
19
20 ![Trello API key page with the API key, Allowed origins, and Secret fields (redacted)](/images/toolkits/trello/api-key-secret.webp)
21
22 5. **Allowed origins** lists the origins Trello may redirect users back to after they authorize. Trello blocks redirects to any origin not on the list. If authorization fails at the redirect step, add `https://backend.composio.dev`.
23
24 ### Create the auth config in Composio
25
26 1. In the [Composio dashboard](https://dashboard.composio.dev/~/project/auth-configs?utm_source=docs&utm_medium=content&utm_campaign=toolkits-trello), go to **Auth Configs** → **Create** and select **Trello**.
27 2. Choose your own credentials. Paste the API key into the consumer key field (`consumer_key`) and the secret into the consumer secret field (`consumer_secret`).
28 3. Click **Create Auth Config**, then click **Connect Account**.
29 4. Click **Allow** on Trello's authorization screen and check that the account shows **Active**.
30
31 See [custom auth configs](/docs/auth-configuration/custom-auth-configs) for the general flow.
32
33 ### Scopes
34
35 The default auth config requests `read`, `write`, and `account`:
36
37 - `read`: read boards, lists, and cards
38 - `write`: create, update, and move cards
39 - `account`: read basic account information
40
41 Request only what you need, for example `read` alone for read-only access.
42
43 ### Keep credentials safe and revoke access
44
45 The API key on its own doesn't grant access to anyone's data. The secret and any user token do, so keep them private. Each Trello user can see and revoke the tokens they've granted at `https://trello.com/u/{username}/account` under **Applications**. Trello can't reset an API key. If yours is exposed, rotate the secret and revoke the affected tokens.