Skip to main content

Permissions & Prerequisites for Salesforce

What you need on the Salesforce side before connecting to Enginy: edition, permissions, authentication, sandbox, and security.

Before connecting Salesforce to Enginy, make sure your organization meets the following requirements. This article covers what you need on the Salesforce side — for step-by-step connection instructions, see How to Configure Your Salesforce Integration.


Salesforce Edition

⚠️ Important: Salesforce requires an edition with API access enabled. This excludes some entry-level editions — check with your Salesforce admin if unsure. This is a requirement from Salesforce itself, not from Enginy.


User Permissions

The Salesforce user connecting the integration needs:

  • API Enabled permission on their profile

  • Read/write access to the objects you want to sync (Contacts, Leads, Accounts)

⚠️ Important: Enginy does not validate these permissions at connection time. The OAuth connection completes successfully even if "API Enabled" is missing, because exchanging the authorization code doesn't require real API access. The failure shows up later, on the first sync, as a generic, non-actionable message ("There was a problem exporting the data to the CRM. Please check CRM Export Reports page and contact support if you still have questions.") — the real Salesforce error (e.g. "API is not enabled for this User") is only logged internally and never shown to you.

That's why it's critical to verify this permission before connecting — if it's missing, you won't get a clear warning; exports will simply fail without a useful explanation.


Authentication

Enginy connects via OAuth 2.0. When you authorize the integration, you'll be asked to grant these scopes:

  • api — access to Salesforce data via API

  • refresh_token / offline_access — allows Enginy to stay connected without you re-authenticating


Sandbox Testing

Not supported.


Security

  • Tokens are refreshed automatically; you don't need to re-authenticate manually.

  • To revoke Enginy's access at any time, do so from Salesforce Setup → Connected Apps → OAuth Usage.

Did this answer your question?