> ## Documentation Index
> Fetch the complete documentation index at: https://docs.definite.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Zendesk Extractor

> Pulling data from Zendesk

## Prerequisite: Getting your Zendesk API Token

To connect Definite to Zendesk, you need the following:

1. Email used for Zendesk account
2. Zendesk Subdomain
3. Zendesk API Token

To get your Zendesk account’s Subdomain:

<Steps>
  <Step>
    Log in to your Zendesk account.
  </Step>

  <Step>
    Go to Support Admin home page by clicking the Gear icon on the left sidebar.  Your subdomain is located in the upper right corner of your screen `yoursubdomain.zendesk.com`

    A faster way to get your subdomain (if the host-mapping feature is not enabled) is to check your URL. Your subdomain is in the account’s URL `'https://yoursubdomain.zendesk.com/agent/admin'`

    <Frame>
      <img src="https://mintcdn.com/definite-a33bcb82/RiEm3iyz76r18fLH/images/extractors/image-38.png?fit=max&auto=format&n=RiEm3iyz76r18fLH&q=85&s=f31d93a0810bf5a0b23f70d4a27f7c50" alt="" width="2880" height="1800" data-path="images/extractors/image-38.png" />
    </Frame>
  </Step>
</Steps>

To get your API token:

<Steps>
  <Step>
    Click the four tile icon located on the upper right corner of your screen, then click `Admin Center`. You will be redirected to a different page.

    <Frame>
      <img src="https://mintcdn.com/definite-a33bcb82/RiEm3iyz76r18fLH/images/extractors/image-39.png?fit=max&auto=format&n=RiEm3iyz76r18fLH&q=85&s=acb931efc428c958f3b21f14a0e0a5b1" alt="" width="2880" height="1696" data-path="images/extractors/image-39.png" />
    </Frame>
  </Step>

  <Step>
    Under **Apps and integrations** > **APIs** > **Zendesk API**, toggle the slider button beside **Token access** to enable API token access.

    <Frame>
      <img src="https://mintcdn.com/definite-a33bcb82/RiEm3iyz76r18fLH/images/extractors/image-40.png?fit=max&auto=format&n=RiEm3iyz76r18fLH&q=85&s=53e3b5a5eb990a58ef4eba1f93574c1e" alt="" width="2880" height="1800" data-path="images/extractors/image-40.png" />
    </Frame>
  </Step>

  <Step>
    Click `Add API token`.

    <Frame>
      <img src="https://mintcdn.com/definite-a33bcb82/RiEm3iyz76r18fLH/images/extractors/image-41.png?fit=max&auto=format&n=RiEm3iyz76r18fLH&q=85&s=658d350d91e02cd8f5dff2d7974b507c" alt="" width="2880" height="1800" data-path="images/extractors/image-41.png" />
    </Frame>
  </Step>

  <Step>
    Enter an API token description. Copy the token and paste it somewhere secure. When you close this window, the full token will never be displayed again.

    <Frame>
      <img src="https://mintcdn.com/definite-a33bcb82/RiEm3iyz76r18fLH/images/extractors/image-42.png?fit=max&auto=format&n=RiEm3iyz76r18fLH&q=85&s=0ee87eb1f42e05347d221eb8b4be3eab" alt="" width="2880" height="1800" data-path="images/extractors/image-42.png" />
    </Frame>
  </Step>

  <Step>
    Click `Save` to return to the Zendesk API page.

    <Frame>
      <img src="https://mintcdn.com/definite-a33bcb82/RiEm3iyz76r18fLH/images/extractors/image-43.png?fit=max&auto=format&n=RiEm3iyz76r18fLH&q=85&s=4c0b1d492d841b5e4be3e19ad1abca10" alt="" width="2880" height="1800" data-path="images/extractors/image-43.png" />
    </Frame>
  </Step>
</Steps>

## Definite instructions

<Steps>
  <Step>
    Go to [this link](https://ui.definite.app/settings/integrations) to add an integration. Search for our Zendesk extractor and click it to get to the creation form.

    <Frame>
      <img src="https://mintcdn.com/definite-a33bcb82/RiEm3iyz76r18fLH/images/extractors/image-44.png?fit=max&auto=format&n=RiEm3iyz76r18fLH&q=85&s=aa433f8ccc037c48a14b6c2815d0072f" alt="" width="2880" height="1800" data-path="images/extractors/image-44.png" />
    </Frame>
  </Step>

  <Step>
    Add a name for your integration, email address that you use for the account, and **Subdomain** and **API Token** from the sections above.

    <Frame>
      <img src="https://mintcdn.com/definite-a33bcb82/RiEm3iyz76r18fLH/images/extractors/image-45.png?fit=max&auto=format&n=RiEm3iyz76r18fLH&q=85&s=66abc0246cd45d0170e70ca818f0ddda" alt="" width="2880" height="1800" data-path="images/extractors/image-45.png" />
    </Frame>
  </Step>

  <Step>
    Finish by clicking `Save`. Definite should automatically take you back to the integrations page where you can see your new Zendesk integration.

    <Frame>
      <img src="https://mintcdn.com/definite-a33bcb82/RiEm3iyz76r18fLH/images/extractors/image-46.png?fit=max&auto=format&n=RiEm3iyz76r18fLH&q=85&s=7706a144c95353e31be4f4abd7bcafdf" alt="" width="2880" height="1800" data-path="images/extractors/image-46.png" />
    </Frame>
  </Step>
</Steps>