How to register a Salesforce developer app and get OAuth 2 credentials

January 24, 2024

In this guide, we'll walk you through how to register a Salesforce developer app to get the OAuth 2 credentials you'll need to be a Salesforce integration for your product. Whether you're planning to build a custom-code integration or using a Unified API solution like Unified.to, retrieving your OAuth 2 credentials is the first step in the process of integrating with Salesforce.

We'll also added directional for existing Unified.to users that are leveraging our Unified CRM API for a faster integration development process.

What is a Salesforce Developer App?

A Salesforce developer app is a container for one or more connected apps. A connected app is an application that can access Salesforce data or functionality through the Salesforce REST, SOAP, or Streaming APIs.

A connected app defines the following information:

  • The name and logo of the app
  • The OAuth settings for the app, such as the callback URL, the scopes, and the refresh token policy
  • The API version and the endpoints for the app
  • The user profiles or permission sets that can access the app By registering a developer app, you can generate a client ID and a client secret, which are the credentials you'll need to authenticate your requests to the Salesforce APIs

Step 1: Register a Salesforce developer app

To register a Salesforce developer app, you'll need a Salesforce developer account. If you don't have one, sign up for free at https://developer.salesforce.com/signup. Once you have a developer account, follow these steps to register a developer app:

  1. Log in to your Salesforce developer account and go to Setup
  2. In the Quick Find box, search for App Manager and click on it
  3. Click on the New Connected App button
  4. Fill in the basic information for your app, such as the name, contact email, and logo URL
  5. In the API (Enable OAuth Settings) section, check the Enable OAuth Settings checkbox
  6. Enter the callback URL for your app (this is the URL that Salesforce will redirect the user to after they authorize your app). For Unified.to users, the callback URL needs to be https://api.unified.to/oauth/code or https://api-eu.unified.to/oauth/code.
  7. Select the OAuth scopes for your app (these are the permissions that your app will request from the user). To set up Unified.to successfully you'll need to add these OAuth Scopes: API access (api) and Platform requests at any time (refresh_token, offline_access). If you are also going to use Salesforce to sign-in your users into your application, then also set the openid,profile,emailscopes.
  8. Next, enable the following options for you app:
    1. Require Secret for Web Server Flow
    2. Require Secret for Refresh Token Flow
    3. Enable Client Credentials Flow
    4. Enable Authorization Code and Credentials Flow
    5. Require user credentials in the POST body for Authorization Code and Credentials Flow
  9. Do NOT enable CODE CHALLENGE (Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows)
  10. Click Save
  11. After you save your app, click Manage Consumer Details to retrieve your "Consumer Key" (client ID) and "Consumer Secret" (client secret). You will need these credentials to activate your Salesforce integration in Unified.to.
  12. Lastly, go back to Apps > Connected Apps > Manage Connected Apps and click Edit next to your app. Under "OAuth Policies" select Refresh token is valid until revoked.

Step 2: Use Unified.to to Simplify Integration Development

Using Salesforce APIs directly can be a complex and time-consuming process, especially if you plan to integrate with other leading CRM platforms like HubSpot, ActiveCampaign, and Copper. Without Unified.to, you'll be tasked with handling authentication, error handling, rate limiting, data mapping, and the synchronization logic for each individual integration.

Unified.to simplifies this entire process, providing SaaS developers with a unified set of APIs, data models, and webhooks for 20+ CRM integrations. Add all the CRM integrations on your roadmap in a matter of hours.

Step 3: Activate Salesforce in Unified.to (for Unified.to users)

  1. Log in and navigate to Active Integrations
  2. Use the search bar or click the CRM tab to select Salesforce
  3. Click Activate on Salesforce
  4. Enter the information from the previous step (client ID, client secret)

Once you've activated Salesforce along with other integrations, you'll be able to add integrations to your product using our low-code authorization UI embed.

One API to integrate them all

You're reading this article on the Unified.to blog. We're a Unified API developer platform for SaaS customer-facing integrations. We're excited to continue to innovate at Unified.to and solve hard, critical integration-related problems for our customers. If you're curious about our integrations-as-a-service solution, consider signing up for a free account or meet with an integrations expert.