Skip to content

Commit 597f6c3

Browse files
amelia-c0nAmelia
amelia-c0n
and
Amelia
authored
feat: added Trello documentation (#2963)
## Description - Added a dedicated monday.com reference doc covering setup, auth, and every built-in command. - Updated `README.md` SaaS grid to include Monday.com alongside existing connectors and reflowed Salesforce positioning. - Registered the new page inside `website/sidebars.js` so it appears in the Connect Data Reference nav. ## Pull request type Check the appropriate box: - [ ] Review Fixes - [ ] Documentation Overhaul - [ x] Feature/Story - Link one or more Engineering Tickets * - [ ] A-Force - [ ] Error in documentation - [ ] Maintenance ## Documentation tickets Link to one or more documentation tickets: - ## Checklist From the below options, select the ones that are applicable: - [ ] Checked for Grammarly suggestions. - [ ] Adhered to the writing checklist. - [ ] Adhered to the media checklist. - [ ] Verified and updated cross-references or added redirect rules. - [ ] Tested the redirect rules on deploy preview. - [ ] Validated the modifications made to the content on the deploy preview. - [ ] Validated the CSS modifications on different screen sizes. Co-authored-by: Amelia <[email protected]>
1 parent bdd2215 commit 597f6c3

File tree

7 files changed

+15736
-1
lines changed

7 files changed

+15736
-1
lines changed

‎website/docs/connect-data/reference/README.md‎

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -334,6 +334,15 @@ Appsmith also supports integration with various Software as a Service (SaaS) pla
334334
</div>
335335

336336
<div className="columnGrid column-two" align="center">
337+
<div className="containerCol">
338+
<a href="/connect-data/reference/trello">
339+
<img className="containerImage referenceIcon" src="https://assets.appsmith.com/trello.png" alt="Trello"/>
340+
</a>
341+
</div>
342+
<b><a href="/connect-data/reference/trello">Trello</a></b>
343+
</div>
344+
345+
<div className="columnGrid column-three" align="center">
337346
<div className="containerCol">
338347
<a href="/connect-data/reference/twilio">
339348
<img className="containerImage referenceIcon" src="https://assets.appsmith.com/twilio.svg" alt="Twilio"/>
@@ -342,7 +351,11 @@ Appsmith also supports integration with various Software as a Service (SaaS) pla
342351
<b><a href="/connect-data/reference/twilio">Twilio</a></b>
343352
</div>
344353

345-
<div className="columnGrid column-three" align="center">
354+
</div>
355+
356+
<div className="containerGrid">
357+
358+
<div className="columnGrid column-one" align="center">
346359
<div className="containerCol">
347360
<a href="/connect-data/reference/zendesk">
348361
<img className="containerImage referenceIcon" src="https://assets.appsmith.com/zendesk.png" alt="Zendesk"/>

‎website/docs/connect-data/reference/trello.md‎

Lines changed: 256 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,256 @@
1+
# Trello
2+
3+
Integrate Trello with Appsmith to create, update, search, and delete cards or boards without leaving your app. Each Trello action returns JSON so you can bind card metadata to widgets, trigger follow-up workflows, or keep your boards in sync with other datasources.
4+
5+
## Connect Trello
6+
7+
1. In Appsmith, create a new Trello datasource.
8+
2. To authorize Trello, log in to your Trello account, review the requested permissions, and click **Allow** to grand Appsmith access to your Trello account.
9+
3. Once connected, you can create a new API by clicking the respective button in the upper right.
10+
11+
## Query Trello
12+
13+
Use the command selector in the query form to pick the Trello operation you need. Each command below lists its parameters along with tips for finding IDs inside Trello.
14+
15+
### Find the Trello IDs
16+
Many of the commands require you to enter certain Trello IDs as parameters. To get those IDs, you can either export your Trello board as a JSON file or install the API Developer ID Helper Power-Up.
17+
18+
#### Export the Board Data as JSON File
19+
To export the board data as a JSON file, follow the steps below:
20+
1. Go to your Trello workspace and select a board.
21+
2. Click the three dots (`...`) on the upper-right corner.
22+
3. Click **Print, export, and share**.
23+
4. Select **Export as JSON**.
24+
25+
<img
26+
src="/img/trello-id1.png"
27+
alt="export Trello workspace as JSON"
28+
caption=""
29+
/>
30+
31+
5. Open the JSON file in a text editor or JSON viewer and grab the IDs:
32+
33+
- `id`: the id of the Trello board
34+
- `idOrganization`: the id of the workspace
35+
- `cards` > `id`: the id of each card
36+
- `labels` > `id`: the id of each label
37+
- `lists` > `id`: the id of each list
38+
- `members` > `id`: the id of each member
39+
- `checklists` > `id`: the id of each checklist of the card
40+
41+
Similarly, you can only export a card as JSON by accessing the card, clicking the three-dots menu > **Share** > **Export JSON**.
42+
43+
<img
44+
src="/img/trello-id2.png"
45+
alt="Trello card Share menu with the Export JSON option highlighted"
46+
caption=""
47+
/>
48+
49+
#### Install the API Developer ID Helper Power-Up
50+
The [API Developer ID Helper Power-Up](https://trello.com/power-ups/646cc3622176aebf713bb7f8) allows Trello API Developers easy access to the technical IDs of a Trello Board (Board ID, List ID, and Card ID) instead of using the JSON export method. Click **Add Power-Up**, then select a board and click **Add**.
51+
Once added, go to the board and follow the instructions from the power-up's page to get the IDs.
52+
53+
<img
54+
src="/img/trello-id3.png"
55+
alt="Add Trello Power-Up"
56+
caption=""
57+
/>
58+
59+
### Create card
60+
61+
Creates a new card in the target list and returns the full Trello card object, including card ID, list ID, labels, and timestamps.
62+
63+
#### List Id `string`
64+
<dd>
65+
Required. [Provide the list ID](#find-the-trello-ids) where the new card should live.
66+
</dd>
67+
68+
#### Name `string`
69+
<dd>
70+
Optional card title. If omitted, Trello uses “Untitled card.”
71+
</dd>
72+
73+
#### Description `string`
74+
<dd>
75+
Optional markdown-friendly description.
76+
</dd>
77+
78+
#### Position `string`
79+
<dd>
80+
Controls the placement within the list. Allowed values: `top`, `bottom`, or any positive float like `5.5` to insert the card between two positions.
81+
</dd>
82+
83+
#### Due Date `string`
84+
<dd>
85+
ISO-8601 timestamp (`2025-12-01T17:00:00.000Z`).
86+
</dd>
87+
88+
#### Is Due Date Complete `string`
89+
<dd>
90+
Marks the due date complete. Allowed values: `yes`, `no`. Leave empty to keep Trello’s default (`no`).
91+
</dd>
92+
93+
#### Member Ids `array`
94+
<dd>
95+
Comma- or JSON-formatted array of Trello [member IDs](#find-the-trello-ids) to assign.
96+
97+
```json
98+
["5d5ea62c8d", "61aa4d128c"]
99+
```
100+
</dd>
101+
102+
#### Label Ids `array`
103+
<dd>
104+
Array of [label IDs](#find-the-trello-ids) to tag the card. Retrieve label IDs from Trello’s board settings.
105+
</dd>
106+
107+
#### Address `string`
108+
<dd>
109+
Optional street address for Map view.
110+
</dd>
111+
112+
#### Location Name `string`
113+
<dd>
114+
Friendly name for the Map pin (for example, “Warehouse-Dock 4”).
115+
</dd>
116+
117+
#### Coordinates `string`
118+
<dd>
119+
Latitude/longitude pair like `40.7505,-73.9934`. Trello expects `lat,long` with four decimal places for precise pins.
120+
</dd>
121+
122+
### Update card
123+
124+
Updates an existing card, moves it between lists or boards, and toggles archive status. Trello returns the updated card payload.
125+
126+
#### Card Id `string`
127+
<dd>
128+
Required. [Provide the Card ID](#find-the-trello-ids) of the card you want to update.
129+
</dd>
130+
131+
#### Board Id `string`
132+
<dd>
133+
Optional destination board. If you change `boardId`, also provide a `listId` that belongs to that board.
134+
</dd>
135+
136+
#### List Id `string`
137+
<dd>
138+
Optional destination list inside the board. Provide this when moving cards between lists.
139+
</dd>
140+
141+
#### Name `string`
142+
<dd>
143+
New card title.
144+
</dd>
145+
146+
#### Description `string`
147+
<dd>
148+
Updated markdown description.
149+
</dd>
150+
151+
#### Is Closed `string`
152+
<dd>
153+
Archives or unarchives the card. Allowed values: `yes` (archive) or `no`.
154+
</dd>
155+
156+
#### Position `string`
157+
<dd>
158+
Same format as **Create card**—`top`, `bottom`, or numeric.
159+
</dd>
160+
161+
#### Due Date `string`
162+
<dd>
163+
New due date in ISO-8601 format (for example, `2025-12-01T17:00:00.000Z`).
164+
</dd>
165+
166+
#### Is Due Date Complete `string`
167+
<dd>
168+
Set to `yes` when the card’s due date should be marked complete; `no` removes the completion flag.
169+
</dd>
170+
171+
#### Member Ids `array`
172+
<dd>
173+
Array of member IDs to set on the card. Provide the entire list of members you want on the card.
174+
175+
```json
176+
["5d5ea62c8d", "61aa4d128c"]
177+
```
178+
You can also provide these programmatically. For example, you could define the options of a MultiSelect widget as Member Ids and include the dynamically selected values in this field:
179+
```js
180+
{{ MembersMultiSelect.selectedOptionValues }}
181+
```
182+
</dd>
183+
184+
#### Label Ids `array`
185+
<dd>
186+
Update the complete label set for the card.
187+
</dd>
188+
189+
#### Address `string`
190+
<dd>
191+
Overwrite the Map view address metadata.
192+
</dd>
193+
194+
#### Location Name `string`
195+
<dd>
196+
Friendly name displayed in Map view.
197+
</dd>
198+
199+
#### Coordinates `string`
200+
<dd>
201+
New `lat,long` pair for the pin (for example, 40.7505,-73.9934). Trello expects lat,long with four decimal places for precise pins.
202+
</dd>
203+
204+
### Get cards in board
205+
206+
Returns every card on the specified board. Useful for populating tables or syncing statuses.
207+
208+
#### Board Id `string`
209+
<dd>
210+
Required. [Provide the ID](#find-the-trello-ids) of the board for which you want to return all cards.
211+
</dd>
212+
213+
### Delete card
214+
215+
Permanently removes a card. Note that this action cannot be undone.
216+
217+
#### Card Id `string`
218+
219+
<dd>
220+
Required. [Provide the ID](#find-the-trello-ids) of the card you want to permanently delete.
221+
</dd>
222+
223+
### Search cards
224+
225+
Uses Trello’s search API to find cards across boards.
226+
227+
#### Query `string`
228+
<dd>
229+
Required search expression. Enter text or a quoted phrase to filter cards that contain the specified value. Note that the search returns a maximum of 1000 cards. If you expect a larger result set or need more advanced filtering, consider using a [Custom action](#custom-action) for greater flexibility and control.
230+
</dd>
231+
232+
### Get lists in board
233+
234+
Fetches metadata for every list on a board to power dropdowns or to map list IDs to human-readable names.
235+
236+
#### Board Id `string`
237+
<dd>
238+
Required board ID. [Provide the board ID](#find-the-trello-ids) for which you want to fetch the lists.
239+
</dd>
240+
241+
### Search boards
242+
243+
Searches boards by name or description.
244+
245+
#### Query `string`
246+
<dd>
247+
Required search phrase. You can include workspace names or the `team:` operator used by Trello search.
248+
</dd>
249+
250+
### Get boards member belong to
251+
252+
Returns all boards accessible to the authenticated Trello member—ideal for populating board pickers without hardcoding IDs. No inputs required.
253+
254+
### Custom action
255+
256+
Use **Custom Action** when you need a Trello REST endpoint that is not modeled above. The form lets you supply the HTTP method, path (for example, `https://api.trello.com/1/cards/{cardId}/attachments`), query parameters, and body. Appsmith automatically injects the OAuth token from your datasource, so you only have to reference [Trello’s API docs](https://developer.atlassian.com/cloud/trello/rest) for the payload structure.

0 commit comments

Comments
 (0)