> For the complete documentation index, see [llms.txt](https://developer.kizen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.kizen.com/docs/integrations-and-plugins/integrations/zendesk/set-up-zendesk-in-kizen.md).

# Set Up Zendesk in Kizen

Configure your connection between the Zendesk platform and Kizen to use live Zendesk data in Agentic Workflows.

{% hint style="success" %}
**Audience:** Admins, Developers, Solution Architects

**Purpose:** Explains how to set up a connection between the Zendesk platform and <code class="expression">space.vars.Kizen\_company\_name</code> using the Zendesk integration
{% endhint %}

## Overview

{% hint style="warning" %}
**Caution:** This setup reflects Kizen's default configuration. Your administrator may have customized your layout, so columns or navigation may appear differently. Trial accounts may have limited features.
{% endhint %}

Setting up the connection between the Zendesk® platform and <code class="expression">space.vars.Kizen\_company\_name</code> is a two-step process. First, you provide your Zendesk subdomain as an integration secret. Next, you follow an OAuth process, which redirects you to the Zendesk platform to assign permissions to the integration. Once you've completed these tasks, you can use Zendesk data in <code class="expression">space.vars.automations</code>.

***

## Before You Begin

To set up Zendesk in <code class="expression">space.vars.Kizen\_company\_name</code>, you need:

* Any paid Zendesk support plan or plan with access to the Zendesk API
* A Zendesk admin account
* A <code class="expression">space.vars.Kizen\_company\_name</code> admin account

***

## Set Up Zendesk in Kizen

To set up Zendesk in <code class="expression">space.vars.Kizen\_company\_name</code>:

{% stepper %}
{% step %}

#### Add the Kizen user to your Zendesk team

If you yourself are the <code class="expression">space.vars.Kizen\_company\_name</code> user, you can skip ahead to [Step 2](#go-to-the-app-marketplace). However, if you aren't the <code class="expression">space.vars.Kizen\_company\_name</code> user, and the <code class="expression">space.vars.Kizen\_company\_name</code> user doesn't yet belong to your Zendesk team, be sure to add them to the team in the Admin Center, and assign them either the Agent or Admin role.

{% hint style="info" %}
**Note:** If you make the <code class="expression">space.vars.Kizen\_company\_name</code> user a Zendesk admin, they can complete this setup process.
{% endhint %}
{% endstep %}

{% step %}

#### Go to the App Marketplace

In <code class="expression">space.vars.Kizen\_company\_name</code>, select **Platform** > **App Marketplace** from the global navigation.

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2Ff2zvupXQYjQcwIKaMtbE%2Fglobal_platformappmarketplace.png?alt=media&amp;token=1165af9b-1c9c-49ce-b64d-02acc6dde887" alt="The App Marketplace menu item under the Platform group in the global navigation" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Activate Zendesk

In the App Marketplace, find the Zendesk card, and select the slider to activate the integration.

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2FUd7EKH000B94e8mxzxNA%2Fzendesk_appon.png?alt=media&amp;token=664b23c6-6d34-4e8b-bcce-733cc6d3bd42" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Add the integration secret

Select **Manage Secrets** on the Zendesk card to open the Integration Secrets Manager in <code class="expression">space.vars.Kizen\_company\_name</code>, and add your Zendesk subdomain as the secret for the Zendesk integration.
{% endstep %}

{% step %}

#### Authorize Zendesk

Back in the App Marketplace, select **Edit Configuration** on the Zendesk card to open the integration's settings page. Then switch to the **Authorization** tab and select **Authorize App**.

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2F3QtqBZqnBsLsr4dbx9J7%2Fzendesk_authorizeapp.png?alt=media&amp;token=edda1dda-0930-4b2b-abe8-bfad8a7f6e4e" alt="The Authorize App button on the Authorization page of the integration settings" width="375"><figcaption></figcaption></figure></div>

The Zendesk platform launches. Log into your Zendesk account, and follow the prompts.

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2FY57PFztvVU6fX8UIg2Wr%2Fzendesk_zendesklogin.png?alt=media&amp;token=5626a526-49a2-47cd-9736-5db65e69287b" alt="The Zendesk login form" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Allow the integration to access your Zendesk account

On the permissions screen, select **Allow**.

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2FqwfCxX85KzoWUA4xHdii%2Fzendesk_allow_integration.png?alt=media&amp;token=717573e9-62ea-4786-a6de-8485dd4e9b68" alt="The Allow button on the page to allow the integration to connect to the Zendesk platform" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Confirm the connection

Back in the authorization settings, check that you have authenticated successfully to the Zendesk API.

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2F9guFdHneXnSxWpZ2YxwR%2Fzendesk_authorized.png?alt=media&amp;token=83de1714-61d3-4e93-8472-2c0cd17af071" alt="The connection confirmation on the Authorization page of the integration settings" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

## What's Next

Continue to [Retrieve Zendesk Data in an Agentic Workflow](/docs/integrations-and-plugins/integrations/zendesk/retrieve-zendesk-data-in-an-agentic-workflow.md) to set up an <code class="expression">space.vars.automation</code> to request live data from the Zendesk platform.

<details>

<summary><strong>Related Topics</strong></summary>

* [Zendesk](/docs/integrations-and-plugins/integrations/zendesk.md)
* [Retrieve Zendesk Data in an Agentic Workflow](/docs/integrations-and-plugins/integrations/zendesk/retrieve-zendesk-data-in-an-agentic-workflow.md)
* [Create or Update Zendesk Data in an Agentic Workflow](/docs/integrations-and-plugins/integrations/zendesk/create-or-update-zendesk-data-in-an-agentic-workflow.md)
* [Troubleshoot Zendesk](/docs/integrations-and-plugins/integrations/zendesk/troubleshoot-zendesk.md)

</details>

***

*Zendesk® and the stylized Z logo are registered trademarks of Zendesk, Inc. Kizen's Zendesk integration is not affiliated with, sponsored by, or endorsed by Zendesk, Inc.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developer.kizen.com/docs/integrations-and-plugins/integrations/zendesk/set-up-zendesk-in-kizen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.