Command · Connector setup

Set up the Zendesk Connector with OAuth

Connect raia Command to Zendesk using OAuth and import knowledge base articles from your Zendesk workspace.

Video walkthrough is available in English.

Overview

The Zendesk connector allows you to import Zendesk knowledge base articles into raia Command.

Zendesk is phasing out API-token authentication for its Support API and has asked customers to migrate affected integrations to OAuth before April 30, 2027.

OAuth should be used for new Zendesk connections. Existing API-token connections can be upgraded from the Zendesk connector in raia Command.

Open the Zendesk connector

01
Log in to raia Command.
02
Open Connectors from the left-hand menu.
03
Select Zendesk.
04
Stay on the Setup & Import tab.
05
Expand the setup instructions.

The page displays the exact redirect URL required when creating the Zendesk OAuth client.

Open the Zendesk OAuth settings

In Zendesk, open Admin Center and go to:

path

Apps and integrations → APIs → Zendesk API → OAuth Clients

Click Add OAuth client.

Create the OAuth client

Enter a recognizable client name, such as raia Command.

You may also add a company name, description, and logo, but these fields are optional.

Enter a unique identifier. This identifier will be used as the OAuth Client ID in raia Command.

Keep the client type set to Confidential.

Add the redirect URL

Copy the redirect URL shown in the Zendesk connector setup instructions in raia Command.

Use this exact redirect URL:

https://spqueahmobhaqgipqkyo.supabase.co/functions/v1/zendesk-oauth-callback

Paste it into the Redirect URLs field in Zendesk.

The redirect URL must match exactly

Copy the complete redirect URL from raia Command. A missing character, additional space, or different URL will prevent Zendesk from completing the OAuth authorization.

Click Save.

Copy the credentials

After the OAuth client is saved, Zendesk generates a client secret.

Copy:

The unique identifier, which is used as the OAuth Client ID
The generated client secret

Copy the secret before leaving the page

Zendesk displays the client secret only once. Copy it immediately and store it securely while completing the connection.

Add the connection in raia Command

Return to the Zendesk connector and click Add connection.

Select the OAuth connection option.

Enter:

A descriptive label
Zendesk subdomain
OAuth Client ID
OAuth Client Secret

The subdomain is the portion before .zendesk.com. For example, if the Zendesk URL is companyname.zendesk.com, enter only companyname.

example

companyname.zendesk.com  →  companyname

Do not enter the complete Zendesk URL.

Click Connect to Zendesk.

Authorize the connection

A Zendesk authorization window will open.

01
Sign in to Zendesk if prompted.
02
Review the requested permissions.
03
Approve the connection.
04
Return to raia Command.
05
Click Recheck Connection.

The connection should display as verified.

Import knowledge base articles

Open the verified Zendesk connection and create a new import.

Select the available Zendesk knowledge base content and choose the destination project and folder in raia Command.

The destination folder must already exist under the appropriate project.

Start the import. raia Command will display the sync status when the import is complete.

Upgrade an existing API-token connection

Existing Zendesk API-token connections may continue working during Zendesk's transition period.

To migrate an existing connection:

01
Locate the legacy Zendesk connection in raia Command.
02
Click Upgrade to OAuth.
03
Create the OAuth client in Zendesk using the steps above.
04
Enter the OAuth Client ID and Client Secret.
05
Complete the Zendesk authorization.
06
Recheck and test the connection.

Verify the connection

Confirm that:

01
The connection displays as verified.
02
Zendesk knowledge base content can be selected.
03
A test import completes successfully.
04
The imported articles appear in the selected raia Command folder.

Command Connectors

All available Command connectors, authentication options, and Sync History.

Projects and folders

Organize destination projects and folders in the Command Data Room.

Vector Stores

How imported content is converted, chunked, embedded, and indexed.