Zendesk

Connecting Leena AI Knowledge Management with Zendesk

This guide walks you through connecting your Zendesk Help Center to Leena AI Knowledge Management (KM), so that Zendesk articles are automatically synced into Leena AI and can be used to answer employee queries.

The setup has two parts:

  1. In Zendesk — create an OAuth client to get a Client ID and Client secret.
  2. In Leena AI KM — use those credentials to configure the integration, choose which categories to sync, and run the sync.
📘

Why OAuth? Zendesk is retiring API tokens. It stops issuing new API tokens on 27 October 2026 and deactivates all existing ones on 30 April 2027. Use OAuth for all new connections. The API token option in Leena AI is kept only for existing connections during the migration window.


Before you begin

Make sure you have:

  • Admin access in Zendesk (required to open Admin Center and create OAuth clients).
  • Your Zendesk domain — for example, company.zendesk.com.
  • Admin access to the Leena AI Knowledge Management dashboard.

Part 1 — Create an OAuth client in Zendesk

With OAuth, you give Leena AI a long-lived OAuth client. Leena AI then generates short-lived access tokens from it on every sync, so you never have to share or rotate a static token.

Step 1: Open OAuth clients

In Zendesk, go to:

Admin Center → Apps and integrations → APIs → OAuth clients

Click Add OAuth client in the top-right corner.

Step 2: Enter the client details

Fill in the following fields:

FieldWhat to enter
NameAny name you like — for example, leena-ai-km-connector.
DescriptionA short description, for example Leena AI KM connector.
CompanyYour company name, or Leena AI.
LogoOptional.
📘

Note: Zendesk creates the client's Identifier from the name you enter. The Identifier is your Client ID in Part 2, so make a note of it.

Step 3: Set the client kind and scopes

Scroll down and set the following:

FieldWhat to enter
Client kindSelect Confidential.
Redirect URLsLeave empty.
Allowed scopesAdd at least hc:read and users:read. You can add other scopes if your setup needs them.
🚧

Important: The client kind must be Confidential. A Public client can't use the client-credentials grant, so Zendesk will reject Leena AI's token requests and the sync will fail.

Step 4: Copy the secret and save

In the Secret section, click Copy and store the secret somewhere safe. Then click Save.

🚧

The secret is shown only once. After you click Save or leave the page, Zendesk won't show it in full again. If you lose it, you'll need to regenerate it from the client's Edit page and update the connection in Leena AI.

You now have the two values you need for Part 2:

  • Client ID — the client's Identifier (shown in the Identifier column on the OAuth clients page).
  • Client secret — the secret you just copied.

Part 2 — Configure the integration in Leena AI KM

Step 1: Open the Zendesk integration

In the Leena AI Knowledge Management dashboard, go to:

Settings → Integrations → Zendesk

This opens the Connect Zendesk setup, which has three stages: Add credentials, Select category, and Configure metadata.

Step 2: Enter the connection name and credentials

Fill in the following fields:

FieldWhat to enter
Connection nameA clear label for this connection — for example, HR Help Center or Zendesk – Production.
DomainYour Zendesk domain — for example, company.zendesk.com.
Authentication methodSelect OAuth.
Client IDThe OAuth client's Identifier from Part 1.
Client secretThe secret you copied in Part 1, Step 4.

Step 3: Configure article settings

On the same page, define how synced Zendesk articles are handled in Leena AI KM:

  • Publish articles as — choose Publish to make synced articles live immediately, or Draft if you want them reviewed before they're published.
  • Article permission — choose Fetch from Zendesk to keep the article permissions set in Zendesk, or Public to follow the permissions set in Leena AI (visible to everyone by default).
  • Expiry window — optionally turn this on to set an expiry date for synced articles and the emails to notify before they expire.

Click Save and next.

📘

Note: You can click Save as draft at any point to save your progress and finish the setup later.

Step 4: Select categories

On the Select category page, Leena AI lists the categories in your Zendesk Help Center. Select the categories you want to sync, or tick Select all categories to sync everything. Use Search category to find a category quickly.

Click Save and next.

Step 5: Configure metadata (optional)

On the Configure metadata page, you can narrow down which articles are synced within each selected category. This step is optional — skip it if you want to sync every article in the selected categories.

To filter a category:

  1. Select the category from the list on the left.
  2. Turn on one or both filters:
    • Based on labels — sync only articles that have the labels you add.
    • Based on sections — sync only articles in the sections you add.
  3. Click Save.
  4. Repeat for any other categories you want to filter.

Step 6: Connect and run the sync

Click Connect to save the integration and start the sync. (When you edit an existing connection later, this button reads Update connection.)

Once the sync completes, your Zendesk articles will be available in the Leena AI Knowledge Management dashboard.


Quick reference

ValueWhere to get it
DomainYour Zendesk URL, e.g. company.zendesk.com
Client IDZendesk → Admin Center → Apps and integrations → APIs → OAuth clients → Identifier column
Client secretShown once when you create the OAuth client (regenerate from the client's Edit page if lost)
Client kindMust be Confidential
Required scopeshc:read, users:read
Categories to syncLeena AI → Connect Zendesk → Select category
Labels / sections (optional filter)Leena AI → Connect Zendesk → Configure metadata

Troubleshooting

ProblemWhat to check
Connection fails with an authentication errorConfirm the Client ID is the client's Identifier (not its display name if you changed it), the secret was copied in full, and the domain has no https:// or trailing path.
Token request is rejectedThe OAuth client's Client kind must be Confidential.
No categories appear, or articles are missingCheck that Allowed scopes includes hc:read and users:read. If you left Allowed scopes empty, all scopes are allowed.
Lost the client secretOpen the OAuth client in Zendesk, regenerate the secret, then update the Client secret in the Leena AI connection.

Did this page help you?