Overview

Pre-built tooling

Pre-built integrations

Not seeing the integration you need? Build your own independently.

Access requirements

Pre-RequisitesStatusComment
Paid dev account✅ Not requiredFree, self-signup for a Salesforce Developer Edition.
Paid test account✅ Not requiredDeveloper Edition can be used for testing.
Partnership✅ Not required
App review✅ Not requiredOnly required for apps published on AppExchange.
Security audit✅ Not required

Setup guide

1

Create a Salesforce Developer account

Go to Salesforce Developer Edition signup page and create a free account.

2

Create a Connected App

  1. Log in to your Salesforce account.
  2. Navigate to Setup (gear icon in the top right) > Open Advanced Setup.
  3. Under PLATFORM TOOLS, click on the Apps dropdown then App Manager.
  4. Click New Connected App in the top right, select Create a Connected App, then click Continue to proceed.
3

Configure Connected App settings

  1. Fill in the required basic information:
    • Connected App Name: Your app’s name
    • API Name: Will auto-populate
    • Contact Email: Your email address
  2. Check the Enable OAuth Settings checkbox.
  3. For Callback URL, enter: https://api.nango.dev/oauth/callback.
  4. Under Selected OAuth Scopes, add the permissions your app needs. At minimum, add:
    • “Access and manage your data (api)”
    • “Perform requests on your behalf at any time (refresh_token, offline_access)”
  5. Check Require Secret for Web Server Flow.
  6. Click Save, then Continue.
    Changes can take up to 10 minutes to take effect
4

Obtain API credentials

  1. After saving, you’ll be redirected to the Connected App detail page.
  2. You may need to wait a few minutes for the app to be fully created.
  3. Click Manage Consumer Details to view your credentials. You may be required to verify your identity.
  4. Copy the Consumer Key (this is your Client ID) and Consumer Secret (this is your Client Secret).
  5. You will need these credentials when configuring your integration in Nango.
5

Configure token settings (recommended)

  1. Under the Connected Apps dropdown, click Manage Connected Apps, then click the Edit button next to your application.
  2. Under OAuth Policies, set Refresh Token Policy to “Refresh token is valid until revoked” for long-lived access.
  3. Click Save.
6

Next

Follow the Quickstart.

Need help getting started? Get help in the community.
TopicLinks
GeneralWebsite
Get a free Developer Edition
Trailhead learning platform
DeveloperAPI documentation
Developer console
Authentication documentation
OAuth authorization code flow
Connected App setup guide
List of OAuth scopes
API rate limits
Contribute useful links by editing this page

Common Scopes

ScopeDescription
apiAccess and manage your data
refresh_token, offline_accessPerform requests on your behalf at any time
chatter_apiAccess Chatter API
custom_permissionsAccess custom permissions
wave_apiAccess Analytics REST API
eclair_apiAccess Einstein Analytics API
pardot_apiAccess Pardot services
lightningAccess Lightning applications

API gotchas

  • If you or your end-user are authorizing a Salesforce sandbox account, you must use the salesforce-sandbox integration in Nango. Your Salesforce Developer Edition account is not a Salesforce sandbox! Use it with the regular salesforce connector.
  • Salesforce calls the client_id and client_secret as Consumer Key and Consumer Secret.
  • To enable offline data access with a refresh token, add the refresh_token (or its synonym, offline_access) scope. By default, access tokens expire in ~2h (but customers can configure this value). Also, check the “Introspect All Tokens” checkbox in your OAuth app settings on the Salesforce developer portal (Salesforce doesn’t share the expiration date of access tokens. Instead, Nango needs to call the Salesforce API to check if access tokens are valid.)
  • If you encounter an error in your flow that says invalid_client_id, make sure your (developer) User’s password does not contain any special characters (yes, really.)
Contribute API gotchas by editing this page