Skip to content
Last updated

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

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

Step 2: Add a new OAuth client

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

Zendesk OAuth clients page

Step 3: Configure the OAuth client

Fill in the following fields:

FieldValue
NameA descriptive name for your application (e.g., Frontegg Integration)
DescriptionA short description of your application
CompanyYour company name
Client kindSelect 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

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

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

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:

ScopeDescription
tickets:readRead ticket data
tickets:writeCreate and update tickets
users:readRead user data
users:writeCreate and update users
organizations:readRead organization data
organizations:writeCreate and update organizations
groups:readRead group data
groups:writeCreate and update groups
tags:readRead tags
tags:writeCreate 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