diff --git a/connectors/trello.mdx b/connectors/trello.mdx new file mode 100644 index 0000000..caeb07a --- /dev/null +++ b/connectors/trello.mdx @@ -0,0 +1,73 @@ +--- +title: Trello +description: Connect Trello to index boards, lists, and cards +--- + +The Trello connector indexes cards and their content from your Trello boards. + +## What gets indexed + +- Cards (titles, descriptions, comments, checklists, attachments) +- Card metadata (board name, list name, labels, assigned members, due dates) + + + Private boards stay private, and are only searchable by users who have access to them. Boards and lists are not independently searchable—they appear as metadata on cards. + + +## Setup + + + + 1. In Grapevine, go to [**Integrations**](https://app.getgrapevine.ai/integrations) and click on **Trello** + 2. Click **Connect Trello Account** to begin the authorization process + + + + 1. You'll be redirected to Trello to authorize the Grapevine Power-Up + 2. Review the requested permissions + 3. Click **Allow** to grant access + + + You need admin permissions on your Trello workspace to install the Power-Up. + + + + + 1. Complete the OAuth 1.0 authentication handshake + 2. The Grapevine Power-Up will be installed as a headless Power-Up + 3. Authorization will apply to all boards accessible to your account + + + + Grapevine will automatically begin indexing your Trello boards and cards. The initial sync may take time depending on the number of boards and cards in your workspace. + + + +## Permissions + +The Trello connector respects Trello permissions: + +- All boards accessible to the authorized account are indexed +- Private boards remain private and are only searchable by authorized users +- Board-level permissions are preserved in search results +- Admin permissions required for initial setup and to index private boards + + + Admin privileges are required to receive webhook events from private boards. If the authorized account loses admin status in an organization, private boards in that organization will no longer sync. + + +## Sync behavior + + + The initial indexing processes all accessible boards and cards. For large workspaces (100+ boards), rate limiting is applied and the sync may take several hours. Real-time updates are configured automatically via webhooks. + + +- **Initial sync** - Begins automatically after authorization +- **Ongoing syncs** - Real-time updates via webhooks keep your index current +- **Deletions** - Deleted cards and boards are removed from the index automatically + +## Limitations + +- Card attachment metadata is indexed, but file contents are not processed +- Archived boards and cards are not indexed +- Admin permissions required to index private boards diff --git a/docs.json b/docs.json index 9e87ccc..29b7324 100644 --- a/docs.json +++ b/docs.json @@ -50,7 +50,8 @@ "connectors/google-drive", "connectors/google-email", "connectors/hubspot", - "connectors/gong" + "connectors/gong", + "connectors/trello" ] } ]