> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Zendesk with OAuth 2.0 (Your Own App) – StackOne Hub

> Link a Zendesk account in the StackOne Hub using OAuth 2.0 (Your Own App). End-user guide to authorize the integration and start using Zendesk actions.

> [!WARNING]
>
> You must be an administrator of your Zendesk account to register an OAuth client.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Find your subdomain

Look at the address bar when signed in to Zendesk. Your subdomain is the first part of the URL, so copy the **Subdomain** across.

<ul>
  <li>Format: `https://{subdomain}.zendesk.com`</li>
  <li>Example: if your URL is `https://acme.zendesk.com/agent/home`, your **Subdomain** is `acme`</li>
</ul>

## Registering an OAuth client

Register the OAuth client in your own Zendesk account.

**1. Enter the client details**

Sign in to your [Zendesk account](https://www.zendesk.com/login/).\
\
Zendesk shows these details to users when they are asked to grant access.

<ul>
  <li>In the top bar, click the product switcher labeled **Support**.</li>
  <li>Select **Admin center**.</li>
  <li>In the sidebar, select **Apps and integrations** > **APIs** > **OAuth clients**.</li>
  <li>Click **Add OAuth client**.</li>
  <li>**Name**: `StackOne Integration`</li>
  <li>**Description**: Short summary of your app</li>
  <li>**Company**: Your company name</li>
  <li>**Logo**: Your company logo</li>
</ul>

![The Add OAuth client form with the Name, Description, and Company fields highlighted](https://mintcdn.com/stackone-60/UqmE9yrzemqSsfXy/connectors/zendesk/images/oauth2_account-config-client-details.png?fit=max\&auto=format\&n=UqmE9yrzemqSsfXy\&q=85\&s=8936261580d60b4af2ae57139ce7a9fe)

**2. Set the identifier, client kind, and redirect URL**

Zendesk fills in the **Identifier** from the name. It must be unique.

<ul>
  <li>**Client kind**: **Confidential**</li>
  <li>**Redirect URLs**: the **Callback URL** from your Connector Profile</li>
</ul>

![The Add OAuth client form with the Identifier, Client kind, and Redirect URLs fields highlighted](https://mintcdn.com/stackone-60/agMuabB96JYIMQc7/connectors/zendesk/images/oauth2_account-config-client-settings.png?fit=max\&auto=format\&n=agMuabB96JYIMQc7\&q=85\&s=52b9030a225f535e3eca4ba2b746fe46)

**3. Select scopes**

Enables actions: Add Tags, Check Brand Host Mapping Validity, Check Host Mapping Validity, Count Organizations, Count Tags, Count Tickets, Count Users, Create Brand, Create Group, Create Group Membership, Create Organization, Create Organization Membership, Create Ticket, Create Ticket Field, Create Ticket Form, Create Trigger, Create User, Delete Brand, Delete Brand Logo, Delete Group, Delete Group Membership, Delete Organization, Delete Organization Membership, Delete Ticket, Delete Ticket Field, Delete Ticket Form, Delete Ticket Trigger, Delete User, List Audits For Ticket, List Brands, List Group Memberships, List Groups, List Organization Memberships, List Organizations, List Resource Tags, List Search Results, List Tags, List Ticket Comments, List Ticket Fields, List Ticket Forms, List Ticket Triggers, List Tickets, List Users, Merge Tickets Into Target Ticket, Remove Tags, Search Organizations, Search Tags, Search Ticket Triggers, Search Users, Set Tags, Show Attachment, Show Brand, Show Group, Show Group Membership, Show Organization, Show Organization Membership, Show Self, Show Ticket, Show Ticket Field, Show Ticket Form, Show Ticket Trigger, Show User, Update Brand, Update Brand Logo, Update Group, Update Organization, Update Ticket, Update Ticket Field, Update Ticket Form, Update Ticket Trigger, Update User, Upload Files

In **Scopes**, click **Select scopes**.

<ul>
  <li>Select each scope listed.</li>
</ul>

![The Scopes field with the selected scopes highlighted](https://mintcdn.com/stackone-60/agMuabB96JYIMQc7/connectors/zendesk/images/oauth2_account-config-scopes.png?fit=max\&auto=format\&n=agMuabB96JYIMQc7\&q=85\&s=d3c2b322f46d5bda2bceb33861047d34)

<ul>
  <li>
    read
  </li>

  <li>
    write
  </li>

  <li>
    tickets:read
  </li>

  <li>
    tickets:write
  </li>

  <li>
    ticket\_attachments:read
  </li>

  <li>
    ticket\_attachments:write
  </li>

  <li>
    users:read
  </li>

  <li>
    users:write
  </li>

  <li>
    organizations:read
  </li>

  <li>
    organizations:write
  </li>

  <li>
    groups:read
  </li>

  <li>
    groups:write
  </li>

  <li>
    brands:read
  </li>

  <li>
    brands:write
  </li>

  <li>
    triggers:read
  </li>

  <li>
    triggers:write
  </li>
</ul>

**4. Save and copy the secret**

Click **Save**. The **Secret** field now shows the generated secret.

<ul>
  <li>Click **Copy** next to **Secret**. Zendesk shows the secret in full only once.</li>
  <li>Click **Save** again to finish creating the client.</li>
</ul>

![The generated Secret with the Copy button highlighted and the secret value masked](https://mintcdn.com/stackone-60/agMuabB96JYIMQc7/connectors/zendesk/images/oauth2_account-config-secret.png?fit=max\&auto=format\&n=agMuabB96JYIMQc7\&q=85\&s=289e80bb3ac62d88452dc80d3a1a9da4)

**5. Copy the client credentials**

Use the **Identifier** and **Secret** from the OAuth client you just saved.

<ul>
  <li>Copy the **Identifier** across to **Client ID**.</li>
  <li>Copy the **Secret** across to **Client Secret**.</li>
</ul>

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Next Steps

> [card] [Webhooks setup](https://docs.stackone.com/connectors/zendesk/guides/webhook-setup.md)
>
> Configure receiving Events for Zendesk into StackOne.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.