Skip to main content

Zendesk Integration

Integrating with Zendesk

Gradual’s Zendesk integration allows you to connect your support documentation with your Gradual community.

Connecting Your Account

You’ll find the Zendesk integration under the Integrations tab. You will need to contact our support team at [email protected] to discuss upgrading to get the integration enabled for your community.

The Integrations page with the Zendesk card highlighted, showing it locked behind an upgrade.

Once the integration is enabled you can connect your account by providing your Zendesk Subdomain. Once connected, Gradual will sync your existing Zendesk knowledge base automatically pulling in published articles.

The Zendesk Authentication panel, asking for the Zendesk subdomain to connect the two accounts.

Article Syncing and Visibility

When syncing articles, you can choose whether they come into Gradual as pending or published, depending on your needs. Only published articles from Zendesk are imported, ensuring that your Gradual dashboard stays relevant.

Each article will be clearly labeled with Zendesk as its source in the dashboard, so it's easy to see which content originated from your knowledge base.

The External Content list with the Source column highlighted, marking which articles came from Zendesk.

Important Notes:
​
-Articles imported from Zendesk will share the same cover image.
-Certain fields are intentionally read-only to ensure consistency across platforms.

Categories and Tags

Gradual supports syncing both categories and tags from Zendesk. You can map Zendesk categories to existing Gradual categories, making it easy to organize your content. Tags from Zendesk will also be pulled into your tag library, and can be used across your Gradual community.

The External Content list with the Category and Tags columns highlighted on the synced articles.

Sync Behavior and Archiving

The integration refreshes every 24 hours, so your content stays in sync automatically. If an article is archived or deleted in Zendesk, it will be tagged as archived in Gradual and hidden from the main community.

If you ever decide to remove the integration, you’ll have full control of what happens to the synced articles. You can either archive the synced articles or keep them in your Gradual workspace.

The remove integration dialog, asking whether to archive or keep the synced articles when Zendesk is disconnected.

Create Zendesk Tickets from Forum Posts

You can connect Zendesk Tickets to Gradual and allow moderators or staff to create a Zendesk ticket directly from a forum post. This feature helps your team escalate community questions into your support workflow without leaving Gradual.

Ticket creation access

The ability to create tickets from forum posts is available to:

  • Forum moderators

  • Board moderators

This feature only supports: Forum Post → Zendesk Ticket. It does not sync updates back to Gradual.

Connect Zendesk Tickets

  1. Sign in to your Gradual dashboard

  2. Open the Zendesk Integration

  3. Complete Zendesk login if not already connected

  4. Locate the Tickets toggle

  5. Toggle On

Once connected, the ticket creation option will be available in the forum.

The Zendesk Integration panel, with the forum posts and knowledge base connections at the top and the sync settings below.

Create a ticket from a forum post

  1. Navigate to the Forum

  2. Open a post

  3. Click the three dots found in the top right corner of the post

  4. Select Create Ticket on Zendesk

  5. Review or edit:

    • Subject (defaults to post title)

    • Description (defaults to post content)

  6. Click Create

A forum post with its menu open and Create Ticket on Zendesk highlighted.

The forum post list with a post's menu open and Create Ticket on Zendesk highlighted.

The Create Zendesk Ticket dialog, with the subject and description prefilled from the forum post.

The forum with a toast confirming a ticket was created on Zendesk and a link to view it.

After creation:

  • A success message will appear

  • A link to the Zendesk ticket will be available

  • The case in Zendesk with be tagged with "Gradual"

Data mapping

When a ticket is created, Gradual sends the following data to Zendesk:

  • Post Title → subject

  • Post Content → description

  • Post Author Email → requester email

  • Topics → tags

  • Gradual Post ID → external_id

  • Post URL and created time → appended to the description

Prevent duplicate tickets

Gradual prevents duplicate tickets using the Post ID. If a ticket already exists, you’ll see: The ticket exists in Zendesk already

If you have questions about the Zendesk integration or want to started, reach out to the team at [email protected]!

Did this answer your question?