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:
- Retrieve your Developer API Keys from Trello
- Add Trello as a Stitch data source
- Define the Historical Sync
- Define the Replication Frequency
Stitch will only have access to the boards that the user who creates the integration has access to. If a board is private and the user isn’t a member, Stitch will be unable to access it. Before beginning the setup process, verify that the user setting up the integration has access to all the boards you want to replicate.
You can use Trello’s Developer Sandbox - no coding knowledge needed - to check your access by simply entering your API Key (see below) and authenticating. Select the Get Boards option and click Execute to see a JSON list of the boards the user has access to.
Retrieving Your Developer API Keys from Trello
- Sign into your Trello account.
- Go to the Trello Developer API Keys page.
- 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
- On the Stitch Dashboard page, click the Add an Integration button.
-
Click the Trello icon.
-
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. - 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
trello_actions
table contains info about the actions related to cards, including the lists that a card belongs to.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
trello_boards
table contains details about all the boards that the connection (authorizing user) has access to.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
trello_cards
table contains info about the latest state of all the cards that the connection (authorizing user) has access to.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
trello_checklists
table contains info about the latest state of all the checklists on cards that the connection (authorizing user) has access to.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 foridchecklist, name, pos,
andstate
.
trello_lists
Replication Method: Full Table
Primary Key: id
Contains Nested Structures?:
No
trello_lists
table contains info about all the lists the connection (authorizing user) has access to.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
trello_users
table contains info about the users in your Trello account/organization.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
Related | Troubleshooting |
Questions? Feedback?
Did this article help? If you have questions or feedback, please reach out to us.