How to Register a ZendeskSell Developer App and Get OAUTH2 Credentials

February 13, 2023

If you are a developer who wants to build data integrations for your SaaS software, you might be interested in using the ZendeskSell API. The ZendeskSell API allows you to access and manipulate data from ZendeskSell, a powerful CRM platform that helps you manage your sales pipeline, contacts, deals, and tasks.

However, before you can use the ZendeskSell API, you need to register a developer app and get credentials. In this article, I will show you how to do that in a few simple steps.

Step 1: Create a ZendeskSell account

If you don't have a ZendeskSell account yet, you need to create one first. You can sign up for a free trial here: https://www.zendesk.com/register/?source=zendesk_sell

Once you have created your account, you can log in to your ZendeskSell dashboard and access the settings menu.

Step 2: Register a developer app

To register a developer app, you need to go to the Admin Settings and click on "APIs > Zendesk APIs" and then on "Oauth Clients". Then, you need to click on the "Add OAUTH2 Client" button and fill in the required information.

You need to provide a name, a description, a logo URL, and a redirect URI for your app. The redirect URI is the URL where ZendeskSell will send the authorization code after the user grants permission to your app. You can use any URL that you control, but it must match the one you will use in your code later. If you are going to use Unified.to, then this needs to be https://api.unified.to/oauth/code

You also need to select the scopes that your app will need to access the ZendeskSell data. The scopes are the permissions that define what your app can do with the ZendeskSell API. You can choose from the following scopes:

  • read: Allows your app to read data from ZendeskSell
  • write: Allows your app to write data to ZendeskSell
  • delete: Allows your app to delete data from ZendeskSell

You can select one or more scopes depending on your app's functionality. However, you should only request the minimum scopes that your app needs to avoid unnecessary access.

After you fill in the information, you can click on the "Register App" button and your app will be created.

Step 3: Get credentials

Once you have registered your app, you will see a confirmation page with your app's credentials. You will need these credentials to authenticate your app with the ZendeskSell API.

The credentials are:

  • Client ID: A unique identifier for your app
  • Client Secret: A secret key that you should keep confidential and never share with anyone

You should copy and save these credentials somewhere safe, as you will need them later in your code.

Step 4: Use Unified.to to Simplify your Integrations Development

Using ZendeskSell APIs directly can be complex and time-consuming, especially if you want to integrate with multiple services or platforms. You will need to handle the authentication, the error handling, the rate limiting, the data mapping, and the synchronization logic for each integration.

A simpler and faster alternative is to use Unified.to APIs for CRM integration. It provides a unified set of APIs, data-models, and webhooks for 20+ CRM integrations.

Step 5: Activate Workday in Unified.to

  1. Navigate to Active Integrations
  2. Search for ZendeskSell
  3. Click on Activate on ZendeskSell
  4. Enter in the information from the previous step (client ID, secret)