Release Status Released Availability Free
Status Page Trello Status Page Default Historical Sync 1 year
Whitelist Tables/Columns Unsupported/Unsupported Default Replication Frequency 30 minutes
Full Table Endpoints 3 Incremental Endpoints 3
Destination Incompatibilities None

Connecting Trello

Connecting your Trello data to Stitch is a four-step process:

  1. Retrieve your Developer API Keys from Trello
  2. Add Trello as a Stitch data source
  3. Define the Historical Sync
  4. Define the Replication Frequency

Retrieving Your Developer API Keys from Trello

  1. Sign into your Trello account.
  2. Go to the Trello Developer API Keys page.
  3. Locate the Key and Secret fields.

Leave this page open for now - you’ll need it to complete the setup in Stitch.

Add Trello as a Stitch Data Source

  1. On the Stitch Dashboard page, click the Add an Integration button.
  2. Click the Trello icon.

  3. Enter a name for the integration. This is the name that will display on the for the integration; it’ll also be used to create the schema in your data warehouse.

    For example, the name “Stitch Trello” would create a schema called stitch_trello in the data warehouse. This schema is where all the tables for this integration will be stored.

  4. Enter your Trello API Key and Secret into their respective fields.

Defining the Historical Sync

The Sync Historical Data setting will define the starting date for your Trello integration. This means that data equal to or newer than this date will be replicated to your data warehouse.

Change this setting if you want to sync data beyond Trello’s default setting of 1 year. For a detailed look at historical syncs, check out the Syncing Historical SaaS Data article.

Define the Replication Frequency

The Replication Frequency controls how often Stitch will attempt to replicate data from your Trello integration. By default the frequency is set to 30 minutes, but you can change it to better suit your needs.

Before setting the Replication Frequency, note that:

  • The more often Trello is set to replicate, the higher the number of replicated rows.
  • The number of rows in the source may not equal the number of rows replicated by Stitch. Tables that use Full Table Replication will result in a higher number of replicated rows.

  • If you’re using a data warehouses that doesn’t natively support nested structures, you’ll see a higher number of replicated rows due to the de-nesting Stitch performs.

To help prevent overages, we recommend setting the Replication Frequency to something less frequent - like 6 hours instead of 30 minutes. For tips on reducing your row count, check out the Reducing Your Row Count section of our Billing Guide.

After selecting a Replication Frequency, click Save Integration.

Trello’s Intial Sync

After you finish setting up Trello, you might see its Sync Status show as Pending on either the Stitch Dashboard or in the Integration Details page.

For a new integration, a Pending status indicates that Stitch is in the process of scheduling the initial sync for the integration. This may take some time to complete.


Trello Schema

Stitch's Trello integration includes these tables:


trello_actions

Replication Method: Incremental
Primary Key: id
Contains Nested Structures?: Yes

The trello_actions table contains info about the actions related to cards, including the lists that a card belongs to.

Table Info & Attributes

trello_actions & Nested Structures

This table contains nested structures. If you use a data warehouse that doesn't natively support nested structures, some of the attributes listed below may be in a subtable.

These items are marked with a *

trello_actions Attributes

While we try to include everything Trello has here, this may not be a full list of attributes. Refer to Trello's documentation for a full list and description of each attribute.

  • Action ID (id)

  • data__board__id

  • data__board__name

  • data__card__id

  • data__card__name

  • idmembercreator

  • member__avatarhash

  • member__fullname

  • member__id

  • member__initials

  • member__username

  • membercreator__avatarhash

  • membercreator__fullname

  • membercreator__id

  • membercreator__initials

  • membercreator__username

  • type

trello_boards

Replication Method: Full Table
Primary Key: id
Contains Nested Structures?: Yes

The trello_boards table contains details about all the boards that the connection (authorizing user) has access to.

Table Info & Attributes

trello_boards & Nested Structures

This table contains nested structures. If you use a data warehouse that doesn't natively support nested structures, some of the attributes listed below may be in a subtable.

These items are marked with a *

trello_boards Attributes

While we try to include everything Trello has here, this may not be a full list of attributes. Refer to Trello's documentation for a full list and description of each attribute.

  • Board ID (id)

  • closed

  • datelastactivity

  • datelastview

  • desc

  • descdata

  • idorganization

  • invitations

  • invited

  • labelnames__black

  • labelnames__blue

  • labelnames__green

  • labelnames__lime

  • labelnames__orange

  • labelnames__pink

  • labelnames__purple

  • labelnames__red

  • labelnames__sky

  • labelnames__yellow

  • name

  • prefs__permissionlevel

  • prefs__voting

  • prefs__comments

  • prefs__invitations

  • prefs__selfjoin

  • prefs__cardcovers

  • prefs__calendarfeedenabled

  • prefs__background

  • prefs__backgroundimage

  • prefs__backgroundimagesscaled*

  • prefs__backgroundtile

  • prefs__backgroundbrightness

  • prefs__canbepublic

  • prefs__canbeorg

  • prefs__canbeprivate

  • prefs__caninvite

  • memberships*

  • powerups*

  • shortlink

  • shorturl

  • starred

  • subscribed

  • url

trello_cards

Replication Method: Incremental
Primary Key: id
Contains Nested Structures?: Yes

The trello_cards table contains info about the latest state of all the cards that the connection (authorizing user) has access to.

Table Info & Attributes

trello_cards & Nested Structures

This table contains nested structures. If you use a data warehouse that doesn't natively support nested structures, some of the attributes listed below may be in a subtable.

These items are marked with a *

This table is updated based on the actions table.

trello_cards Attributes

While we try to include everything Trello has here, this may not be a full list of attributes. Refer to Trello's documentation for a full list and description of each attribute.

  • Card ID (id)

  • desc

  • checkitemstates*

  • idchecklists*

  • idlabels*

  • idmembers*

  • labels*

  • closed

  • datelastactivity

  • due

  • duecomplete

  • idattachmentcover

  • idboard

  • idlist

  • idshort

  • manualcoverattachment

  • name

  • pos

  • shorturl

  • url

  • badges__attachments

  • badges__checkitems

  • badges__checkitemschecked

  • badges__comments

  • badges__description

  • badges__due

  • badges__duecomplete

  • badges__subscribed

  • badges__viewingmembervoted

  • badges__votes

trello_checklists

Replication Method: Incremental
Primary Key: id
Contains Nested Structures?: Yes

The trello_checklists table contains info about the latest state of all the checklists on cards that the connection (authorizing user) has access to.

Table Info & Attributes

trello_checklists & Nested Structures

This table contains nested structures. If you use a data warehouse that doesn't natively support nested structures, some of the attributes listed below may be in a subtable.

These items are marked with a *

This table is updated based on the actions table.

trello_checklists Attributes

While we try to include everything Trello has here, this may not be a full list of attributes. Refer to Trello's documentation for a full list and description of each attribute.

  • Checklist ID (id)

  • idboard

  • idcard

  • name

  • pos

  • checkitems*: Contains columns for idchecklist, name, pos, and state.

trello_lists

Replication Method: Full Table
Primary Key: id
Contains Nested Structures?: No

The trello_lists table contains info about all the lists the connection (authorizing user) has access to.

Table Info & Attributes

trello_lists Attributes

While we try to include everything Trello has here, this may not be a full list of attributes. Refer to Trello's documentation for a full list and description of each attribute.

  • List ID (id)

  • closed

  • idboard

  • name

  • pos

  • subscribed

trello_users

Replication Method: Full Table
Primary Key: id
Contains Nested Structures?: No

The trello_users table contains info about the users in your Trello account/organization.

Table Info & Attributes

trello_users Attributes

While we try to include everything Trello has here, this may not be a full list of attributes.

  • User ID (id)

  • fullname

  • username



Questions? Feedback?

Did this article help? If you have questions or feedback, please reach out to us.