Discourse Zendesk

[Discourse]

	Summary	Create Zendesk tickets from Discourse topics.
	Install Guide	This plugin is bundled with Discourse core. There is no need to install the plugin separately.

As this is an official plugin maintained by the Discourse team, Support, Contribute > Bug, Contribute > UX, and Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started.

 Support  Bug  UX  Feature

As Zendesk will permanently deactivate API-token authentication on April 30, 2027, existing installations need to migrate to authentication via OAuth.

Features

Create Zendesk tickets

This plugin allows you to create Zendesk tickets from Discourse topics. This can be done either by configuring the plugin so that all topics in a category automatically generate Zendesk tickets, or by pushing individual topics to Zendesk by clicking the “Create Zendesk Ticket” button that’s displayed for site staff below each topic:

When the ticket is created, the author of the topic’s first post will be set as the Requester on Zendesk. They will also be added to your Zendesk customers list.

After the ticket has been created, the “Create Zendesk Ticket” button will be updated to “View on Zendesk.” Clicking that button will take you to the associated Zendesk ticket:

Push replies created on Discourse to Zendesk

The plugin allows you to optionally push all replies to the Discourse topic to the Zendesk ticket, or to only push replies created by the topic’s author. Both of these features are configurable via the plugin’s settings.

Sync Zendesk comments with Discourse

Zendesk comment can be synced with the Discourse topic that the ticket originated on.

Configuration

The Discourse Zendesk settings can be accessed from the Plugins page of your Discourse site’s Admin section. Click the “Settings” button for the “discourse-zendesk-plugin” entry on that page.

Configure OAuth

First, create an OAuth client in Zendesk:

1. In Zendesk Admin Center, go to Apps and integrations > APIs > OAuth clients.
2. Click Add OAuth client.
3. Enter a name, description and select Confidential as the client kind. A redirect URL is not required.
4. Configure Scopes to tickets:read, tickets:write, users:read, and users:write to restrict the OAuth client to only the scopes required by the plugin.
5. Save the client.
6. Copy the client’s Identifier and Secret. Zendesk displays the complete secret only once.

Configure these Discourse settings:

• zendesk oauth client id: enter the OAuth client’s Identifier.
• zendesk oauth client secret: enter the OAuth client’s Secret.

Other settings

• zendesk url: enter your Zendesk account URL followed by /api/v2. For example, https://example.zendesk.com/api/v2.

• zendesk enabled: enable or disable the plugin.

• zendesk jobs api token: Deprecated. Existing installations should migrate to OAuth.

• zendesk jobs email: Deprecated. Existing installations should migrate to OAuth.

• zendesk autogenerate all categories (formerly zendesk enable all categories): automatically create Zendesk tickets for topics in every category. This setting is disabled by default.

• zendesk autogenerate categories (formerly zendesk enabled categories): select the Discourse categories whose new topics should automatically create Zendesk tickets.

• zendesk job push all posts: push replies to Zendesk as ticket comments. This setting is enabled by default.

• zendesk job push only author posts: only push replies written by the original topic author. This setting applies when zendesk job push all posts is enabled and is disabled by default.

• sync comments from zendesk and zendesk incoming webhook token: sync comments from Zendesk to Discourse. See How to enable Zendesk two-way sync.

• zendesk tags: an optional list of tags to add to Zendesk tickets created from Discourse.

Last edited by @tgxworld 2026-09-01T00:27:49Z

Check document

Perform check on document: