What this article covers:
Required permissions for each integration
OAuth Scopes info for each integration
In order to sync the things you care about, Unito needs the authorization to make changes within your tools. For most tools, the authorization process is fairly simple. However, there are some permissions you should check so we can sync without issues. Here are these permissions, outlined for each tool.
Trello
Just make sure the user account selected for the flow is a member of the Trello Board you want to sync.
OAuth Scopes
Read | reading of boards, organizations, etc. on behalf of the user |
Write | writing of boards, organizations, etc. on behalf of the user |
Account | read member email, writing of member info, and marking notifications read |
Jira
In order to sync your Jira projects, you'll need a mix of global and project-specific permissions, from login permissions to issue and comment permissions. You can find the full list of user permissions here.
Note that you need administrator permissions to connect your Jira account to Unito. Once the account is connected, you only need project-level admin permissions to create a flow.
If you get stuck on setting up permissions schemes in Jira, you can find a guide here.
OAuth Scopes
Read | View, browse, and read information from Jira. |
Write | Create or edit content in Jira, but not delete content. |
Asana
Your account needs to be a full member of your organization, not a guest. Then, make sure the account is part of the Asana team that owns the project you want to sync.
OAuth Scopes
Default | Provides access to all endpoints documented in our API reference. |
Teamwork
In order to properly sync tasks, Unito users need to be a Client User in Teamwork and not just a Collaborator.
Beyond that, Unito only needs special permissions if you want to create Teamwork projects directly from Unito. To do this, you must have administrator permissions in Teamwork or permission to add projects. If you don't have these permissions, reach out to someone who has administrator permissions.
GitHub
You need to both be a member of the organization that owns the repository you want to sync and a collaborator (which is different from a contributor). If your organization has enabled third-party application restrictions, you'll need to follow this step-by-step guide for approving third-party apps in GitHub.
In addition, we need the repository permission that includes “repository webhooks for public and private repositories” to create webhooks. We do not require the admin:repo_hook permission. You can get more information about these permissions here.
Most importantly, Unito will never ask for, or require access to, any code you have stored on GitHub.
Note: We can't sync a repository if it was forked from another repository.
OAuth Scopes
Repository Permissions
Read | Metadata | Search repositories, list collaborators, and access repository metadata. |
Read & Write | Pull requests | Pull requests and related comments, assignees, labels, milestones, and merges. |
Read & Write | Webhooks | Manage the post-receive hooks for a repository. |
Read & Write | Projects | Manage repository projects, columns, and cards. |
Organization Permissions
Read | Members | Organization members and teams. |
Read & Write | Webhooks | Manage the post-receive hooks for an organization. |
Read & Write | Projects | Manage organization projects, columns, and cards. |
User Permissions
Read | Email Address | Manage a user's email addresses. |
Zendesk
Confirm that your Zendesk account has admin privileges. We need this in order to search for certain endpoints and create webhooks.
OAuth Scopes
Read | gives an app read access to all resources (tickets, users, auditlogs - read only, organizations, hc, apps, triggers, automations, targets) |
Wrike
Make sure the project or folder is shared with the account you're using for your workflows. Also, because all projects and folders in Wrike are private by default, the ones you want to sync need to be shared with the account used to sync them.
HubSpot
All you need is to make sure you're a member of the HubSpot account that needs syncing.
OAuth Scopes
Contacts | Provides access to Contact, Companies, Deals, Properties, Engagements, and Owners endpoints |
GitLab
The GitLab account you use with Unito needs to be a member of the organization that owns the repository that you want to sync. You'll also need push — or read/write — access.
We use webhooks to improve workflow performance. To create those webhooks, the GitLab account you use with Unito must have Maintainer or Owner-level permissions. That's because we need the Configure project hooks permission. You can learn more about GitLab's user permissions here.
Bitbucket
Just like GitLab and GitHub, your account needs to be part of the organization that owns the repositories you need to sync and you'll need push access. Beyond that, you'll also need the issue tracker enabled on the repository, which is disabled by default.
Basecamp
Being a member of the Basecamp workspace that needs syncing should be enough. No special permissions required!
monday
No special permissions required!
OAuth Scopes
me:read | Read your basic personal details |
boards:read | Read boards data |
boards:write | Modify boards data |
users:read | Access data about your account's users |
updates:read | Read updates data |
updates:write | Modify updates data |
teams:read | Read teams data |
account:read | Access information about your account |
ClickUp
Just connect your account and you're ready to go.
Smartsheet
Add your Smartsheet account to Unito and you'll be ready to sync your Sheets. No additional permissions needed.
OAuth Scopes
CREATE_SHEETS | Create new sheets. |
ADMIN_WEBHOOKS | Create, delete, and update webhooks; get all webhooks; reset shared secret. |
READ_CONTACTS | Retrieve contacts. |
READ_SHEETS | Read all sheet data, including attachments, discussions, and cell data. |
READ_USERS | Retrieve users and groups for your Smartsheet organization account. |
WRITE_SHEETS | Insert and modify sheet data, including attachments, discussions, and cell data. |
DELETE_SHEETS | Delete sheets. |
Slack
Add your Slack account to Unito and you'll be ready to sync your conversations. No additional permissions needed.
OAuth Scopes
channels:history | View messages and other content in public channels that your slack app has been added to |
channels:join | Join public channels in a workspace |
channels:manage | Manage public channels that your slack app has been added to and create new ones |
channels:read | View basic information about public channels in a workspace |
chat:write | Manage a user’s public channels and create new ones on a user’s behalf |
groups:history | View messages and other content in private channels that your slack app has been added to |
groups:read | View basic information about private channels that your slack app has been added to |
mpim:history | View messages and other content in group direct messages that your slack app has been added to |
users:read | View people in a workspace |
users:read.email | View email addresses of people in a workspace |
Google Sheets
During the authorization process, you'll need to give Unito access to your Google account so your flow can see and edit your sheets.
Read & Write | Metadata | Access to the user's file metadata, excluding downloadUrl and thumbnail |
Read & Write | Sheets | Allows read/write access to the user's sheets and their properties. |
Read | Email address | View your email address |
Read | Profile | See your personal info, including any personal info you’ve made publicly available |
Notion
During the authorization process, you'll need to select the pages or databases you want to give Unito access to — along with its children.
Read & Write | Pages (view and edit) | View and edit pages you select in the next step. You can also share pages later with the Unito via the Share menu. |
Read & Write | Pages (create new) | Add new pages/databases inside pages it has access to. |
Read | Email address | View all workspace members and guests and their email addresses. |