All Collections
FAQ
Connections and authentication
What access does Gearset need when connecting to a Salesforce org?
What access does Gearset need when connecting to a Salesforce org?
Valerio Chang avatar
Written by Valerio Chang
Updated over a week ago

When Gearset first connects to a Salesforce org, it requests a range of permissions:

The primary permission that underlies this is the Modify all data permission. To use Gearset to deploy both metadata and data between your orgs, the user (actually, the user's profile) you used to authenticate against the org must have this permission.

Why does Gearset need this permission?

As a deployment tool, Gearset needs the ability to read and write org metadata and data. 

What if I'm not using data deployment?

There is an Administrative Permission named Modify Metadata Through Metadata API Functions. In theory, this setting should be enough to allow you to use the metadata functionality of Gearset. However, we've found some inconsistencies with this setting. Even if you're only looking to utilize metadata, it's still sometimes necessary to grant the Modify All Data permission.

Our recommendation would be to grant the Modify All Data permission. But please be aware that unless you're using Gearset's data loader, the app will never read or write any org data.

Can I control this access?

Gearset's access to an org can be revoked from within the org at any point by the end user, via the Connected Apps OAuth Usage page.

Did this answer your question?