{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21607,"path":"integrate-applications/integration-hub/setup-zendesk.md","title":"Set up the Zendesk spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Set up the Zendesk spoke\n\nIntegrate the ServiceNow instance and Zendesk by creating a custom OAuth application in Zendesk to authenticate ServiceNow requests.\n\n## Before you begin\n\n-   Request an Integration Hub subscription.\n-   Activate the Zendesk spoke.\n-   Role required: admin.\n\n## Create a Zendesk OAuth client\n\nCreate an OAuth client for authenticating Zendesk API requests.\n\n### Before you begin\n\nRole required: Zendesk admin\n\n### Procedure\n\n1.  From a web browser, open [Zendesk](https://www.zendesk.com).\n\n2.  Log in using your admin credentials.\n\n    The Zendesk Agent Workspace opens.\n\n3.  On the left navigation menu of the Zendesk Agent Workspace, select the Admin icon \\(\\[Omitted image \"admin-icon.png\"\\] Alt text: Admin icon.\\).\n\n    The Admin menu opens.\n\n4.  From the Admin menu, navigate to **Channels** &gt; **API**.\n\n    The Zendesk API page opens.\n\n5.  Select the **OAuth Clients** tab and then click **Add OAuth client**.\n\n6.  The Create a new OAuth client form opens.\n\n7.  On the form, fill in the fields.\n\n<table id=\"table_aym_sgf_cqb\"><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nClient name\n\n</td><td>\n\nName of the OAuth client.\n\n</td></tr><tr><td>\n\nDescription\n\n</td><td>\n\nBrief description of the OAuth client.\n\n</td></tr><tr><td>\n\nCompany\n\n</td><td>\n\nName of the company whose data the OAuth client grants access to through the Zendesk API. The company name is displayed during authentication of your Zendesk API requests.This field populates automatically based on the company that your Zendesk account is associated with. However, you can modify the company name as needed.\n\n</td></tr><tr><td>\n\nLogo\n\n</td><td>\n\nLogo that is displayed during authentication of your Zendesk API requests. Click the green square to locate and select the logo that you want to display.\n\n</td></tr><tr><td>\n\nUnique identifier\n\n</td><td>\n\nUnique identifier for the OAuth client. This field populates automatically based on the OAuth client name that you specified in the **Client name** field. However, you can modify the unique identifier as needed.**Note:** The unique identifier is used only in the Zendesk code.\n\n</td></tr><tr><td>\n\nRedirect URLs\n\n</td><td>\n\nURL of the OAuth provider that users are redirected to after authentication. Enter `https://*instance*.service-now.com/oauth_redirect.do`, where &lt;*instance*&gt; is the name of your ServiceNow instance.\n\n</td></tr></tbody>\n</table>8.  Click **Save**.\n\n    The Please store the secret that will appear dialog box opens.\n\n9.  On the dialog box, click **OK**.\n\n    The dialog box closes and the form reloads.\n\n10. Copy the value in the **Secret** field.\n\n    Save this in a secure location for later use.\n\n\n## Create a Zendesk connection\n\nCreate a connection between your Zendesk applications and your ServiceNow instance so that your instance can retrieve user data from your applications.\n\n### Before you begin\n\nRole required: ServiceNow admin\n\n### Procedure\n\n1.  From your ServiceNow instance, navigate to **Process Automation** &gt; **Flow Designer**.\n\n    The Flow Designer launches in a new tab.\n\n2.  Select the **Connections** tab.\n\n3.  Locate your Zendesk connection and then click **Add Connection**.\n\n    The Create Connection dialog box opens.\n\n4.  On the dialog box, fill in the fields.\n\n    |Field|Description|\n    |-----|-----------|\n    |Connection Information|\n    |Connection Name|Name of the Zendesk connection. This field populates automatically.|\n    |Connection URL|URL for the connection. Enter `https://<subdomain>.zendesk.com`, where &lt;*subdomain*&gt; is your organization subdomain.|\n    |Credential Information|\n    |OAuth Client ID|Unique identifier for your Zendesk OAuth client. Enter the same unique identifier that you specified in [Create a Zendesk OAuth client](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-zendesk.md).|\n    |OAuth Client Secret|Secret that is assigned to your Zendesk OAuth client. Enter the same secret that you copied in [Create a Zendesk OAuth client](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-zendesk.md).|\n    |OAuth Redirect URL|URL of the OAuth provider that users are redirected to after authentication. This field populates automatically based on the redirect URL that you specified in [Create a Zendesk OAuth client](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-zendesk.md).|\n\n5.  Click **Create and Get OAuth Token**.\n\n    The Zendesk OAuth authorization dialog box opens.\n\n6.  On the dialog box, click **Authorize**.\n\n    The OAuth access token becomes available for authorizing your Zendesk connection.\n\n7.  In your ServiceNow instance, add OAuth entity profile scope.\n\n    1.  Navigate to **System OAuth** &gt; **Application Registry**.\n\n    2.  Open the record for the Zendesk spoke. For example, **Zendesk OAuth**.\n\n    3.  In the **OAuth Entity Profiles** tab, open the default record, for example, **Zendesk.OAuthProfile**.\n\n    4.  Insert a new row with these values.\n\n        |Field|Value|\n        |-----|-----|\n        |OAuth Entity Scope|users:write read|\n        |OAuth scope|write read|\n\n\n"}}