Building your first integration - Part 2: Obtaining an OAuth token
OAuth 2.0 is an industry-wide authorization protocol standard. ZIS relies on OAuth 2.0 for securing access to data. To use any ZIS service, you must first obtain a ZIS OAuth token using the ZIS Connections API.
This tutorial is the second part of a series on building your first integration:
- Part 1 - Creating your first integration
- Part 2 - Obtaining an OAuth token - YOU ARE HERE
- Part 3 - Creating your first ZIS Flow
In this tutorial, you'll go through the steps to obtain a ZIS OAuth token using Postman, an API testing tool. See Exploring Zendesk APIs with Postman. You can also use the same approach with other API clients that support OAuth 2.0.
The Zendesk OAuth client's identifier and secret when you created the integration name in the previous tutorial.
The OAuth token is used to make authenticated requests to ZIS in the next tutorial.
To obtain an OAuth token
In Postman, create a new request and leave the request URL empty for now.
Select the Authorization tab.
In the Type dropdown option, select OAuth 2.0.
In the Add authorization data to dropdown option, select Request URL.
Complete the Configure New Token section with the following information:
Field Value Token Name A token name. Example: "my ZIS token" Grant Type Authorization Code Callback URL https://zis.zendesk.com/api/services/zis/connections/oauth/callback (Leave the "Authorize using browser" checkbox unchecked) Auth URL https://
Access Token URL https://
Client ID The client's identifier returned after registering the integration. This is a string starting with
Client Secret The client's secret returned after registering the integration Scope read write (See Using OAuth authentication with your application to learn more about Zendesk OAuth scopes) State Leave it empty Client Authentication Send as Basic Auth header
<SUBDOMAIN>with your Zendesk subdomain.
Here's an example of what your setup should look like:
We recommend using environment variables in Postman to safely manage sensitive data.
Click Get New Access Token. A popup window will take you through the OAuth flow. Once completed, another window will display the newly obtained access token. Example:
Click Use Token in the upper-right corner. Now you are ready to make requests and interact with ZIS.