> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://apidocs.polytomic.com/2021-05-23/configuring-your-connections/connections/zendesk-support/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.polytomic.com/_mcp/server.

# Zendesk Support

Supports:
* ✅ Models
* ✅ Model sync destination
* ✅ Bulk sync source
* ✅ Connection Proxy


## Connection

### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>auth_method</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Authentication method<br/><br/>Accepted values: `apitoken` <a href="#auth-method-apitoken">↓</a>, `clientcredentials` <a href="#auth-method-clientcredentials">↓</a>, `oauth`</td>
<td><code>required</code></td>
</tr>
<tr>
<td><code>custom_api_limits</code></td>
<td><code>boolean</code></td>
<td style="vertical-align: top;">Enforce custom API limits <a href="#custom-api-limits-true">↓</a></td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>domain</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Zendesk subdomain</td>
<td><code>required</code></td>
</tr>
<tr>
<td><code>oauth_refresh_token</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">(required if `auth_method` is "oauth")</td>
<td><code>optional</code></td>
</tr>
</tbody>
</table>

<a id="auth-method-apitoken"></a>

#### `auth_method`

When `auth_method` is `apitoken`:

<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>api_token</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">API token</td>
<td><code>required</code></td>
</tr>
<tr>
<td><code>email</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Email</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>

```json
{
  "name": "Zendesk Support connection",
  "type": "zendesk_support",
  "configuration": {
    "api_token": "secret-token",
    "auth_method": "apitoken",
    "custom_api_limits": false,
    "domain": "polytomic.zendesk.com",
    "email": "user@example.com",
    "oauth_refresh_token": "dasfdasz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq"
  }
}
```

<a id="auth-method-clientcredentials"></a>

When `auth_method` is `clientcredentials`:

<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>client_id</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Client ID</td>
<td><code>required</code></td>
</tr>
<tr>
<td><code>client_secret</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Client secret</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>

```json
{
  "name": "Zendesk Support connection",
  "type": "zendesk_support",
  "configuration": {
    "auth_method": "clientcredentials",
    "client_id": "",
    "client_secret": "",
    "custom_api_limits": false,
    "domain": "polytomic.zendesk.com",
    "oauth_refresh_token": "dasfdasz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq"
  }
}
```

<a id="custom-api-limits-true"></a>

#### `custom_api_limits`

When `custom_api_limits` is `true`:

<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>ratelimit_rpm</code></td>
<td><code>integer</code></td>
<td style="vertical-align: top;">Maximum requests per minute<br/><br/>Set a custom maximum request per minute limit.</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>

```json
{
  "name": "Zendesk Support connection",
  "type": "zendesk_support",
  "configuration": {
    "api_token": "secret-token",
    "auth_method": "apitoken",
    "custom_api_limits": true,
    "domain": "polytomic.zendesk.com",
    "email": "user@example.com",
    "oauth_refresh_token": "dasfdasz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq",
    "ratelimit_rpm": 0
  }
}
```



## Model Sync
### Source
#### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>object</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Object</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>


#### Example
```json
{
  ...
  "configuration": {
    "object": "tickets"
  }
}
```


### Target
Zendesk Support connections may be used as the destination in a model sync.
#### All targets

##### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>replace_relationships</code></td>
<td><code>boolean</code></td>
<td style="vertical-align: top;">Replace existing relationships</td>
<td><code>optional</code></td>
</tr>
</tbody>
</table>


##### Example
```json
{
  ...
  "target": {
      "configuration": {
        "replace_relationships": false
    }
  }
}
```









## Bulk Sync
### Source
Zendesk Support connections may be used as a bulk sync source. No additional configuration options are required.