How (and Why) to Use a Service Account (or Bot User) as Your Mirror Sync Account

Service accounts, also known as bot users, are useful for removing confusion about who is commenting or changing a task. Here's how to set one up. 

In this article:

What is a service account or bot user?

When you first sign up for Mirror, your list of available boards to mirror will be limited to boards that your account has access to. But if you're part of a larger team with more boards to sync, you may want to create a new Trello account with access to all of them.

The account you connect to Mirror will also be designated as the source of any changes or comments synced. 

Example: If Charlotte connects Mirror to her team's Trello account and Ben leaves a comment in a mirrored card, the synced comment in the other card will appear to be from Charlotte instead of Ben.

That's why a bot user or service account can be useful and avoid confusion.

The advantage of having a service account (or bot user) as your sync account

If Hannah sets up Mirror with her own personal account, this is how a comment from another user (Billie) would look when it is synced:

While it does specify who the comment was from within the comment itself, it is still attributed to Hannah, and this may cause some confusion.

With a service account, you remove this confusion because the comment owner is the neutral connector, making the rightful commenter more evident. We recommend using the name Mirror or Mirror Bot for your service account just to make it more clear where it's coming from.

How to set up a service account (or bot user) as your sync account

1. Create the service account

Creating a service account in any of your favorite tools is pretty straightforward: you just create another user in Trello with a different email and give it access to the boards you want to sync.

Pro tip: If you're using Gmail, you don't have to create a new email address; you can just add a "+syncbot" at the end of your name (e.g. bryan+syncbot@company.org) and it will count as a new address, while still receiving all emails.

Make sure the service account (or bot user) is an Admin of your team and a Board Admin in any of the Trello boards you want to sync. It will ensure all information is well synced.

2. Clear Power-Up board and organization data

You need to log in as the sync account — or as an admin on your Trello board — to access these settings.

3. Log into Trello as the service account user and authorize the Power-Up

After authorizing the Power Up using the service account, this will then update the sync account to the service account.

Any new mirrors made will now be associated with the service account.

4. Switch old mirrors to the service account

After making the above changes, only new mirrors will be associated with the service account. To switch the old mirrors to the service account, follow the below steps:

  1. Open the Unito App and make sure you're logged in to your Trello account.

  2. Once logged in to Unito, log out from your personal user in Trello.

  3. Edit the Mirrors you would like to switch over:

From within the “Boards” tab, add your service account to your Mirror for both boards.

Your Mirror will begin synchronizing with the new connector.

Note: You can only change a connector that has access to the synchronized board. If the service account (or bot user) is grayed out, some permissions are missing.