## Zendesk integration

Zendesk is a customer service and support platform that provides ticketing, help desk, and customer engagement tools. Integrating Zendesk with Frontegg allows your application to manage tickets, users, organizations, groups, and tags on behalf of your users through OAuth 2.0 authentication.

Prerequisites
- A Zendesk account with admin access
- Access to the [Zendesk Admin Center](https://support.zendesk.com/hc/en-us/articles/4408845965210-Using-OAuth-authentication-with-your-application)


### Connect Zendesk

#### Step 1: Sign in to Zendesk Admin Center

Sign in to your Zendesk account at `https://your-subdomain.zendesk.com/admin/`. In the left sidebar, expand **Apps and integrations**, then scroll to the **APIs** section and click **OAuth clients**.

![Zendesk Admin Center OAuth clients navigation](/assets/zendesk-1.717c04efeb184f6c1c253c9c8a37143a49cbd10f13f86e175de68e1a10b70ca7.1ce25488.png)

#### Step 2: Add a new OAuth client

On the OAuth clients page, click the **Add OAuth client** button.

![Zendesk OAuth clients page](/assets/zendesk-2.f931ad2d975cff547733d2cecae29b3ee1b6315bc1ee37f2a19730697157cbff.1ce25488.png)

#### Step 3: Configure the OAuth client

Fill in the following fields:

| Field | Value |
|  --- | --- |
| **Name** | A descriptive name for your application (e.g., `Frontegg Integration`) |
| **Description** | A short description of your application |
| **Company** | Your company name |
| **Client kind** | Select **Confidential** |


The **Identifier** field auto-populates based on the name. This value serves as your **Client ID** when configuring the integration in the Frontegg portal.

![Zendesk OAuth client form](/assets/zendesk-3.b5d9519667e1fba440e88d8a1d40f6e3eeac3b5786b6f0940e8d5344d5e681ab.1ce25488.png)

#### Step 4: Copy your credentials

Click **Save**. After saving, Zendesk displays the **Secret** value. Copy it immediately and store it securely.

Keep your credentials secure
The Client Secret is displayed in its entirety only once. If you lose it, you will need to regenerate a new one from the Edit page.

![Zendesk OAuth client credentials](/assets/zendesk-5.fb9b6cee1b3e6a77aa13040e4fab03a2905df3fb15584cd55b66ed38a14a917e.1ce25488.png)

#### Step 5: Configure redirect URIs

Scroll down to the **Redirect URLs** field and enter the following callback URIs, each on a new line:

- `https://YOUR_MCP_GATEWAY_URL/integration-callback`


If your Zendesk account only allows one redirect URI, use the first one.

Click **Save** to apply the changes.

![Zendesk redirect URIs configuration](/assets/zendesk-6.5801367c7c1df404057dea762286924dbea29c9350e97ff01617b1b24b0b3b42.1ce25488.png)

#### Step 6: Note the required scopes

Zendesk OAuth scopes are specified during the authorization request rather than configured in the Admin Center. The following scopes are available:

| Scope | Description |
|  --- | --- |
| `tickets:read` | Read ticket data |
| `tickets:write` | Create and update tickets |
| `users:read` | Read user data |
| `users:write` | Create and update users |
| `organizations:read` | Read organization data |
| `organizations:write` | Create and update organizations |
| `groups:read` | Read group data |
| `groups:write` | Create and update groups |
| `tags:read` | Read tags |
| `tags:write` | Create and manage tags |


Minimum required scopes
For basic ticket and user management, select at minimum: `tickets:read`, `tickets:write`, `users:read`, and `users:write`.

### Configure the Frontegg portal

Once you have your **Client ID** (the Identifier field) and **Client Secret** from the steps above, enter them in the integration configuration page of the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → Zendesk.
2. Enter your Zendesk **subdomain** (e.g., `your-company` from `your-company.zendesk.com`).
3. Enter the **Client ID** and **Client Secret** in the corresponding fields.
4. Select the required **scopes**.
5. Click **Save**.


### Additional resources

- [Zendesk OAuth authentication guide](https://support.zendesk.com/hc/en-us/articles/4408845965210-Using-OAuth-authentication-with-your-application)
- [Zendesk API documentation](https://developer.zendesk.com/api-reference/)
- [Zendesk Developer Terms](https://www.zendesk.com/company/agreements-and-terms/zendesk-developer-terms/)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)