> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/zendesk.md).

# Zendesk

Zendesk is a customer service platform for managing support tickets, help centers, and customer interactions.

* Knowledge base source

## Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector        | Authentication |
| ---------------- | -------------- |
| Zendesk (OAuth2) | OAuth sign-in  |
| Zendesk          | Credentials    |

### Zendesk (OAuth2)

Connect to Zendesk via OAuth2 to manage customer support tickets and support interactions.

#### Set up in Zendesk

1. Use a Zendesk account with access to the records and operations that your workflow needs.
2. If your organization restricts application access or user consent, have its administrator approve the connection before you sign in.

#### Set up in StackAI

1. Open **Settings → Connections**, add a connection, and select **Zendesk (OAuth2)**.
2. Select **Connect**, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

StackAI obtains the OAuth credentials during sign-in. You do not need to paste an access token or refresh token.

**Provider documentation:** [Setup reference](https://developer.zendesk.com/documentation/api-basics/authentication/creating-and-using-oauth-tokens-with-the-api/).

### Zendesk

Connect to Zendesk using API token to manage customer support tickets and support interactions.

#### Set up in Zendesk

1. Sign in to Zendesk as an administrator and open Admin Center.
2. Go to Apps and integrations → APIs → Zendesk API and make sure Token access is enabled.
3. Click Add API token, give it a descriptive name, then Save, and copy the token (it is shown in full only once).

#### Set up in StackAI

1. Open **Settings → Connections**, add a connection, and select **Zendesk**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field | Required                 | What to enter                                                                                                |
| ------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------ |
| Subdomain     | Yes                      | The subdomain of the Zendesk instance (e.g., 'mycompany' for mycompany.zendesk.com).                         |
| Domain        | Optional / as applicable | The domain of the Zendesk instance (default: 'zendesk').                                                     |
| Email         | Yes                      | Should be the same email you use to login to administer your Zendesk account.                                |
| API Token     | Yes                      | The API token for the Zendesk user. Found in: Admin > Apps and integrations > APIs > Zendesk API > Settings. |

**Provider documentation:** [Setup reference](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-API-token-access-to-the-Zendesk-API).

### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

### Detailed setup guides

* [Connect Zendesk](https://docs.stackai.com/integrations/catalog/zendesk/connect-zendesk.md)

## Use an action

1. Add the required **Zendesk** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

## Actions

| Action                                                                | Purpose                                                                                                                                                                    | Required inputs                                      |
| --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| List Assignable Groups And Agents Based On Query Matched Against Name | List assignable groups and agents based on query matched against name                                                                                                      | Name                                                 |
| List Assignable Groups On The Assigneefield                           | List assignable groups on the AssigneeField                                                                                                                                | None listed                                          |
| List Assignable Agents From A Group On The Assigneefield              | List assignable agents from a group on the AssigneeField                                                                                                                   | Group Id                                             |
| Get Sources By Target                                                 | Returns a list of source objects whose values are populated with the id of a related target object.                                                                        | Target Type, Target Id, Field Id, Source Type        |
| Show Settings                                                         | Shows the settings that are available for the account.                                                                                                                     | None listed                                          |
| Update Account Settings                                               | Updates settings for the account.                                                                                                                                          | None listed                                          |
| Create Trial Account                                                  | Use this tool to post create trial account                                                                                                                                 | None listed                                          |
| Verify Subdomain Availability                                         | Zendesk Support credentials are not required to access this endpoint.                                                                                                      | Subdomain                                            |
| List Activities                                                       | Lists ticket activities in the last 30 days affecting the agent making the request.                                                                                        | None listed                                          |
| Show Activity                                                         | Lists a specific activity.                                                                                                                                                 | None listed                                          |
| Count Activities                                                      | Returns an approximate count of ticket activities in the last 30 days affecting the agent making the request.                                                              | None listed                                          |
| Report Channelback Error To Zendesk                                   | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Push Content To Support                                               | Pushes Channel framework content to Zendesk.                                                                                                                               | None listed                                          |
| Validate Token                                                        | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Create Approval Workflow Instance                                     | Creates an approval workflow instance attached to a ticket.                                                                                                                | None listed                                          |
| Create An Approval Request                                            | Creates an approval request that is attached to a ticket.                                                                                                                  | None listed                                          |
| Show Approval Request                                                 | Shows an approval request.                                                                                                                                                 | None listed                                          |
| Update Approval Request Status                                        | Updates the approver's decision about an approval request.                                                                                                                 | None listed                                          |
| Get Approvals By Approval Workflow Id                                 | Returns a list of approvals associated with a specific workflow instance.                                                                                                  | None listed                                          |
| Show Attachment                                                       | Shows attachment details.                                                                                                                                                  | Attachment Id                                        |
| Update Attachment For Malware                                         | Toggles enabling or restricting agent access to attachments with detected malware.                                                                                         | Attachment Id                                        |
| List Audit Logs                                                       | Allowed for: Admins on accounts that have audit log access.                                                                                                                | None listed                                          |
| Show Audit Log                                                        | Allowed for: Admins on accounts that have audit-log access.                                                                                                                | None listed                                          |
| Export Audit Logs                                                     | Allowed for: Admins on accounts that have audit log access.                                                                                                                | None listed                                          |
| Search Tags                                                           | Returns an array of registered and recent tag names that start with the characters specified in the name query parameter.                                                  | None listed                                          |
| List Automations                                                      | Lists all automations for the current account.                                                                                                                             | None listed                                          |
| Create Automation                                                     | Creates an automation.                                                                                                                                                     | None listed                                          |
| Delete Automation                                                     | Note: You might be restricted from deleting some default automations.                                                                                                      | None listed                                          |
| Show Automation                                                       | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Update Automation                                                     | Updates an automation.                                                                                                                                                     | None listed                                          |
| List Active Automations                                               | Lists all active automations.                                                                                                                                              | None listed                                          |
| Bulk Delete Automations                                               | Deletes the automations corresponding to the provided comma-separated list of IDs.                                                                                         | None listed                                          |
| Search Automations                                                    | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Update Many Automations                                               | Note: You might be restricted from updating some default automations.                                                                                                      | None listed                                          |
| List Bookmarks                                                        | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Create Bookmark                                                       | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Delete Bookmark                                                       | Allowed for: Agents (own bookmarks only).                                                                                                                                  | None listed                                          |
| List Brand Agent Memberships                                          | Returns a list of all brand agent memberships for your account.                                                                                                            | User Id, Brand Id                                    |
| Show Brand Agent Membership                                           | Returns a brand agent membership for your account.                                                                                                                         | Brand Agent Id                                       |
| List Brands                                                           | Returns a list of all brands for your account sorted by name.                                                                                                              | None listed                                          |
| Create Brand                                                          | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Delete A Brand                                                        | Deletes a brand.                                                                                                                                                           | Brand Id                                             |
| Show A Brand                                                          | Returns a brand for your account.                                                                                                                                          | Brand Id                                             |
| Update A Brand                                                        | Returns an updated brand.                                                                                                                                                  | Brand Id                                             |
| Check Host Mapping Validity For An Existing Brand                     | Returns a JSON object determining whether a host mapping is valid for the given brand.                                                                                     | Brand Id                                             |
| Check Host Mapping Validity                                           | Returns a JSON object determining whether a host mapping is valid for a given subdomain.                                                                                   | Host Mapping, Subdomain                              |
| List Monitored X Handles                                              | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Show Monitored X Handle                                               | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Create Ticket From Tweet                                              | Turns a tweet into a ticket.                                                                                                                                               | None listed                                          |
| List Ticket Statuses                                                  | Allowed for: Agents.                                                                                                                                                       | Comment Id                                           |
| Open Ticket In Agent\&#39;S Browser                                   | Allows you to instruct an agent's browser to open a ticket.                                                                                                                | Agent Id, Ticket Id                                  |
| Open A User\&#39;S Profile In An Agent\&#39;S Browser                 | Allows you to instruct an agent's browser to open a user's profile.                                                                                                        | Agent Id, User Id                                    |
| Create Ticket Or Voicemail Ticket                                     | Allowed for: Agents.                                                                                                                                                       | Agent Id, Ticket Id                                  |
| Redact Chat Comment Attachment                                        | Permanently removes one or more chat attachments from a chat ticket.                                                                                                       | None listed                                          |
| Redact Chat Comment                                                   | Permanently removes words or strings from a chat ticket's comment.                                                                                                         | None listed                                          |
| Redact Ticket Comment In Agent Workspace                              | Redaction allows you to permanently remove words, strings, or attachments from a ticket comment.                                                                           | None listed                                          |
| List Custom Objects                                                   | Lists all undeleted custom objects for the account                                                                                                                         | None listed                                          |
| Create Custom Object                                                  | Creates an object describing all the properties required to create a custom object record                                                                                  | None listed                                          |
| Delete Custom Object                                                  | Permanently deletes the custom object with the specified key                                                                                                               | Custom Object Key                                    |
| Show Custom Object                                                    | Returns an object with the specified key                                                                                                                                   | Custom Object Key                                    |
| Update Custom Object                                                  | Updates an individual custom object.                                                                                                                                       | Custom Object Key                                    |
| List Custom Object Fields                                             | Lists all undeleted custom fields for the specified object.                                                                                                                | Custom Object Key                                    |
| Create Custom Object Field                                            | Creates any of the following custom field types: See About custom field types in Zendesk help.                                                                             | Custom Object Key                                    |
| Delete Custom Object Field                                            | Deletes a field with the specified key.                                                                                                                                    | Custom Object Key, Custom Object Field Key Or Id     |
| Show Custom Object Field                                              | Returns a custom field for a specific object using a provided key or id of the field.                                                                                      | Custom Object Key, Custom Object Field Key Or Id     |
| Update Custom Object Field                                            | Updates individual custom object fields.                                                                                                                                   | Custom Object Key, Custom Object Field Key Or Id     |
| Reorder Custom Fields Of An Object                                    | Sets a preferred order of custom fields for a specific object by providing field ids in the desired order.                                                                 | Custom Object Key                                    |
| Custom Object Record Bulk Jobs                                        | Queues a background job to perform bulk actions on up to 100 custom object records per single request.                                                                     | Custom Object Key                                    |
| Custom Object Fields Limit                                            | List the current count and the limit for a custom object's fields                                                                                                          | Custom Object Key                                    |
| Delete Custom Object Record By External Id Or Name                    | Deletes a record with the specified external id or name.                                                                                                                   | Custom Object Key, External Id, Name                 |
| List Custom Object Records                                            | Lists all undeleted custom object records for the specified object                                                                                                         | Custom Object Key                                    |
| Set Custom Object Record By External Id Or Name                       | If a record exists for the given external id or name, updates it.                                                                                                          | Custom Object Key, External Id, Name                 |
| Create Custom Object Record                                           | Creates a custom object record according to all the properties described by a custom object definition.                                                                    | Custom Object Key                                    |
| Delete Custom Object Record                                           | Deletes a record with the specified id                                                                                                                                     | Custom Object Key, Custom Object Record Id           |
| Show Custom Object Record                                             | Returns a custom record for a specific object using a provided id.                                                                                                         | Custom Object Key, Custom Object Record Id           |
| Update Custom Object Record                                           | Updates an individual custom object record.                                                                                                                                | Custom Object Key, Custom Object Record Id           |
| Autocomplete Custom Object Record Search                              | Retrieves an array of custom object records that have a field value that matches the value specified in the name parameter.                                                | Custom Object Key                                    |
| Count Custom Object Records                                           | Returns a total count of records for a specific custom object as well as the time the count was refreshed.                                                                 | Custom Object Key                                    |
| Search Custom Object Records                                          | Returns an array of custom object records that meet the search criteria                                                                                                    | Custom Object Key                                    |
| Filtered Search Of Custom Object Records                              | Returns an array of custom object records that meet the search and filter criteria.                                                                                        | Custom Object Key                                    |
| List Object Triggers                                                  | Lists all triggers for the specified custom object.                                                                                                                        | Custom Object Key                                    |
| Create Object Trigger                                                 | Creates a new object trigger for a specified object.                                                                                                                       | None listed                                          |
| Delete Object Trigger                                                 | Deletes a specified object trigger.                                                                                                                                        | None listed                                          |
| Show Object Trigger                                                   | Returns details of a specific object trigger.                                                                                                                              | None listed                                          |
| Update Object Trigger                                                 | Updates a specified object trigger.                                                                                                                                        | None listed                                          |
| List Active Object Triggers                                           | Lists all active object triggers.                                                                                                                                          | None listed                                          |
| List Object Trigger Action And Condition Definitions                  | Lists the conditions and actions of all triggers for the specified custom object.                                                                                          | None listed                                          |
| Delete Many Object Triggers                                           | Deletes the object triggers corresponding to the provided comma-separated list of ids.                                                                                     | None listed                                          |
| Search Object Triggers                                                | Returns a list of object triggers that meet your filter or search criteria.                                                                                                | None listed                                          |
| Update Many Object Triggers                                           | Updates the position or the active status of multiple object triggers.                                                                                                     | None listed                                          |
| Custom Objects Limit                                                  | List the current count and the limit for custom objects                                                                                                                    | None listed                                          |
| Custom Object Records Limit                                           | List the current count and the limit for custom object records                                                                                                             | None listed                                          |
| List Custom Roles                                                     | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Create Custom Role                                                    | Allowed for: Administrators, Agents with the manage\_roles permission.                                                                                                     | None listed                                          |
| Delete Custom Role                                                    | Allowed for: Administrators, Agents with the manage\_roles permission.                                                                                                     | None listed                                          |
| Show Custom Role                                                      | Allowed for: Administrators, Agents with the manage\_roles permission.                                                                                                     | None listed                                          |
| Update Custom Role                                                    | Allowed for: Administrators.                                                                                                                                               | None listed                                          |
| Bulk Update Default Custom Ticket Status                              | Updates the default values for many custom ticket statuses at once.                                                                                                        | None listed                                          |
| List Custom Ticket Statuses                                           | Lists all undeleted custom ticket statuses for the account.                                                                                                                | None listed                                          |
| Create Custom Ticket Status                                           | Takes a custom\_status object that specifies the custom ticket status properties to create.                                                                                | None listed                                          |
| Show Custom Ticket Status                                             | Returns the custom ticket status object.                                                                                                                                   | Custom Status Id                                     |
| Update Custom Ticket Status                                           | Takes a custom\_status object that specifies the properties to update.                                                                                                     | Custom Status Id                                     |
| Create Ticket Form Statuses For A Custom Status                       | Creates one or many tickets form status associations for a custom status.                                                                                                  | None listed                                          |
| List Deleted Tickets                                                  | Returns a maximum of 100 deleted tickets per page.                                                                                                                         | None listed                                          |
| Delete Ticket Permanently                                             | Permanently deletes a soft-deleted ticket.                                                                                                                                 | Ticket Id                                            |
| Restore A Previously Deleted Ticket                                   | Allowed for: Agents.                                                                                                                                                       | Ticket Id                                            |
| Delete Multiple Tickets Permanently                                   | Permanently deletes up to 100 soft-deleted tickets.                                                                                                                        | Ids                                                  |
| Restore Previously Deleted Tickets In Bulk                            | Allowed for: Agents.                                                                                                                                                       | Ids                                                  |
| List Deleted Users                                                    | Returns deleted users, including permanently deleted users.                                                                                                                | None listed                                          |
| Permanently Delete User                                               | Before permanently deleting a user, you must delete the user first.                                                                                                        | None listed                                          |
| Show Deleted User                                                     | Returns users that have been deleted but not permanently yet.                                                                                                              | None listed                                          |
| Count Deleted Users                                                   | Returns an approximate count of deleted users, including permanently deleted users.                                                                                        | None listed                                          |
| List Deletion Schedules                                               | Lists all deletion schedules for the account.                                                                                                                              | None listed                                          |
| Create Deletion Schedule                                              | Creates a new deletion schedule.                                                                                                                                           | None listed                                          |
| Delete Deletion Schedule                                              | Deletes a deletion schedule by its id.                                                                                                                                     | Deletion Schedule Id                                 |
| Get Deletion Schedule                                                 | Gets a deletion schedule by its id.                                                                                                                                        | Deletion Schedule Id                                 |
| Update Deletion Schedule                                              | Updates a deletion schedule by its id.                                                                                                                                     | Deletion Schedule Id                                 |
| List Items                                                            | Returns a list of all dynamic content items for your account if accessed as an admin or agents who have permission to manage dynamic content.                              | None listed                                          |
| Create Item                                                           | Create a new content item, with one or more variants in the item's variants array.                                                                                         | None listed                                          |
| Delete Dynamic Content Item                                           | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Show Item                                                             | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Update Item                                                           | The only attribute you can change is the name.                                                                                                                             | None listed                                          |
| List Variants                                                         | Returns all the variants of the specified dynamic content item.                                                                                                            | None listed                                          |
| Create Variant                                                        | You can only create one variant for each locale id.                                                                                                                        | None listed                                          |
| Delete Variant                                                        | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Show Variant                                                          | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Update Variant                                                        | Updates the specified variant.                                                                                                                                             | None listed                                          |
| Create Many Variants                                                  | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Update Many Variants                                                  | Updates one or more variants.                                                                                                                                              | None listed                                          |
| Show Many Items                                                       | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| List Email Notifications                                              | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Show Email Notification                                               | Shows details on an email notification.                                                                                                                                    | None listed                                          |
| Show Many Email Notifications                                         | Shows details of many email notifications.                                                                                                                                 | None listed                                          |
| List Group Memberships                                                | Allowed for: Agents.                                                                                                                                                       | Group Id, User Id                                    |
| Create Group Membership                                               | Assigns an agent to a given group.                                                                                                                                         | None listed                                          |
| Delete Group Membership                                               | Immediately removes a user from a group and schedules a job to unassign all working tickets that are assigned to the given user and group combination.                     | None listed                                          |
| Show Group Membership                                                 | The 'id' is the group membership id, not a group id.                                                                                                                       | None listed                                          |
| List Assignable Memberships                                           | Returns a maximum of 100 group memberships per page.                                                                                                                       | None listed                                          |
| Bulk Create Memberships                                               | Assigns up to 100 agents to given groups.                                                                                                                                  | None listed                                          |
| Bulk Delete Group Memberships                                         | Immediately removes users from groups and schedules a job to unassign all working tickets that are assigned to the given user and group combinations.                      | None listed                                          |
| List Group Sla Policies                                               | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Create Group Sla Policy                                               | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Delete Group Sla Policy                                               | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Show Group Sla Policy                                                 | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Update Group Sla Policy                                               | Updates the specified policy.                                                                                                                                              | None listed                                          |
| Retrieve Group SLA Policy Filter Definition Items                     | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Reorder Group Sla Policies                                            | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| List Groups                                                           | Allowed for: Admins, Agents.                                                                                                                                               | User Id                                              |
| Create Group                                                          | Allowed for: Admins, Agents assigned to a custom role with permissions to manage groups (Enterprise only).                                                                 | None listed                                          |
| Delete Group                                                          | Allowed for: Admins, Agents assigned to a custom role with permissions to manage groups (Enterprise only).                                                                 | None listed                                          |
| Show Group                                                            | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Update Group                                                          | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| List Assignable Groups                                                | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Count Groups                                                          | Returns an approximate count of groups.                                                                                                                                    | None listed                                          |
| Ticket Import                                                         | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Ticket Bulk Import                                                    | Accepts an array of up to 100 ticket objects.                                                                                                                              | None listed                                          |
| Incremental Sample Export                                             | Use this endpoint to test the incremental export format.                                                                                                                   | None listed                                          |
| Incremental Organization Export                                       | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Incremental Attributes Values Export                                  | Returns a stream of changes that occurred on routing attribute values.                                                                                                     | None listed                                          |
| Incremental Attributes Export                                         | Returns a stream of changes that occurred on routing attributes.                                                                                                           | None listed                                          |
| Incremental Instance Values Export                                    | Returns a stream of changes that occurred on routing instance values.                                                                                                      | None listed                                          |
| Incremental Ticket Event Export                                       | Returns a stream of changes that occurred on tickets, excluding events occuring within one minute of the request.                                                          | None listed                                          |
| List Ticket Metric Events                                             | Returns ticket metric events that occurred on or after the start time.                                                                                                     | Start Time                                           |
| List Recent Tickets                                                   | Returns the tickets that were created or changed since a start time.                                                                                                       | Start Time                                           |
| Incremental Ticket Export, Cursor Based                               | Returns the tickets that changed since the start time.                                                                                                                     | None listed                                          |
| Incremental User Export, Time Based                                   | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Incremental User Export, Cursor Based                                 | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| List Job Statuses                                                     | Shows the statuses for background jobs.                                                                                                                                    | None listed                                          |
| Show Job Status                                                       | Shows the status of a background job.                                                                                                                                      | None listed                                          |
| Show Many Job Statuses                                                | Accepts a comma-separated list of job status ids.                                                                                                                          | Ids                                                  |
| List Locales                                                          | Lists the translation locales available for the account.                                                                                                                   | None listed                                          |
| Show Locale                                                           | Allowed for: Anyone.                                                                                                                                                       | None listed                                          |
| List Locales For Agent                                                | Lists the translation locales that have been localized for agents on a specific account.                                                                                   | None listed                                          |
| Show Current Locale                                                   | This works like Show Locale, but instead of taking a locale id as an argument, it renders the locale of the user performing the request.                                   | None listed                                          |
| Detect Best Language For User                                         | Allowed for: Anyone.                                                                                                                                                       | None listed                                          |
| List Available Public Locales                                         | Lists the translation locales that are available to all accounts.                                                                                                          | None listed                                          |
| List Macros                                                           | Lists all shared and personal macros available to the current user.                                                                                                        | None listed                                          |
| Create Macro                                                          | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Delete Macro                                                          | Allowed for: Agents, with restrictions applying on certain actions.                                                                                                        | None listed                                          |
| Show Macro                                                            | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Update Macro                                                          | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Show Changes To Ticket                                                | Returns the changes the macro would make to a ticket.                                                                                                                      | None listed                                          |
| List Macro Attachments                                                | Lists the attachments associated with a macro.                                                                                                                             | None listed                                          |
| Create Macro Attachment                                               | Allows an attachment to be uploaded and associated with a macro at the same time.                                                                                          | None listed                                          |
| List Supported Actions For Macros                                     | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| List Active Macros                                                    | Lists all active shared and personal macros available to the current user.                                                                                                 | None listed                                          |
| Create Unassociated Macro Attachment                                  | Allows an attachment to be uploaded that can be associated with a macro at a later time.                                                                                   | None listed                                          |
| Show Macro Attachment                                                 | Shows the properties of the specified macro attachment.                                                                                                                    | None listed                                          |
| List Macro Categories                                                 | Lists all macro categories available to the current user.                                                                                                                  | None listed                                          |
| List Macro Action Definitions                                         | Returns the definitions of the actions a macro can perform.                                                                                                                | None listed                                          |
| Bulk Delete Macros                                                    | Deletes the macros corresponding to the provided comma-separated list of IDs.                                                                                              | Ids                                                  |
| Show Macro Replica                                                    | Returns an unpersisted macro representation derived from a ticket or macro.                                                                                                | None listed                                          |
| Search Macros                                                         | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Update Many Macros                                                    | Updates the provided macros with the specified changes.                                                                                                                    | None listed                                          |
| List Clients                                                          | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Create Client                                                         | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Delete Client                                                         | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Show Client                                                           | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Update Client                                                         | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Generate Secret                                                       | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| List Global Oauth Clients                                             | Returns all the global OAuth clients that users on your account have authorized.                                                                                           | None listed                                          |
| List Tokens                                                           | Returns the properties of the tokens for the current user.                                                                                                                 | None listed                                          |
| Create Token                                                          | Returns an OAuth access token with a specified scope.                                                                                                                      | None listed                                          |
| Revoke Token                                                          | Allowed for: Admins, Agents, End Users.                                                                                                                                    | None listed                                          |
| Show Token                                                            | Returns the properties of the specified token.                                                                                                                             | None listed                                          |
| Delete Essentials Card                                                | Delete the essentials card for an object type.                                                                                                                             | None listed                                          |
| Show Essentials Card                                                  | Gets the essentials card for an object type.                                                                                                                               | None listed                                          |
| Update Essentials Card                                                | Updates the essentials card for an object type.                                                                                                                            | None listed                                          |
| List Of Essentials Cards                                              | Gets the list of essentials cards.                                                                                                                                         | None listed                                          |
| List Organization Fields                                              | Returns a list of custom organization fields in your account.                                                                                                              | None listed                                          |
| Create Organization Field                                             | Creates any of the following custom field types: See About custom field types in Zendesk help.                                                                             | None listed                                          |
| Delete Organization Field                                             | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Show Organization Field                                               | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Update Organization Field                                             | Dropdown and multiselect fields return an array of custom\_field\_options which specify the name, value, and order of dropdown or multiselect options.                     | None listed                                          |
| Reorder Organization Field                                            | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| List Organization Memberships                                         | Returns a list of organization memberships for the account, user or organization in question.                                                                              | None listed                                          |
| Create Organization Membership                                        | Assigns a user to a given organization.                                                                                                                                    | None listed                                          |
| Delete Organization Membership                                        | Immediately removes a user from an organization and schedules a job to unassign all working tickets currently assigned to the user and organization combination.           | None listed                                          |
| Show Organization Membership                                          | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Create Many Memberships                                               | Accepts an array of up to 100 organization membership objects.                                                                                                             | None listed                                          |
| Bulk Delete Organization Memberships                                  | Immediately removes a user from an organization and schedules a job to unassign all working tickets currently assigned to the user and organization combination.           | None listed                                          |
| Show Organization Merge                                               | Retrieves the details of a specific organization merge operation.                                                                                                          | None listed                                          |
| List Organization Subscriptions                                       | Allowed for: Agents, End users.                                                                                                                                            | None listed                                          |
| Create Organization Subscription                                      | Allowed for: Agents, End users.                                                                                                                                            | None listed                                          |
| Delete Organization Subscription                                      | Allowed for: Agents, End users.                                                                                                                                            | Organization Subscription Id                         |
| Show Organization Subscription                                        | Allowed for: Agents, End users.                                                                                                                                            | Organization Subscription Id                         |
| List Organizations                                                    | Allowed for: Agents, with certain restrictions.                                                                                                                            | None listed                                          |
| Create Organization                                                   | You must provide a unique name for each organization.                                                                                                                      | None listed                                          |
| Delete Organization                                                   | Allowed for: Admins, Agents assigned to a custom role with permissions to manage organizations (Enterprise only).                                                          | None listed                                          |
| Show Organization                                                     | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Update Organization                                                   | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Merge Organization With Another Organization                          | Merges two organizations by moving all users, tickets, and domain names from the organization specified by {organization\_id} to the organization specified by winner\_id. | None listed                                          |
| List Organization Merges                                              | Retrieves a list of all organization merge operations associated with a given organization.                                                                                | None listed                                          |
| Show Organization\&#39;S Related Information                          | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Autocomplete Organizations                                            | Returns an array of organizations whose name starts with the value specified in the name parameter.                                                                        | None listed                                          |
| Count Organizations                                                   | Returns an approximate count of organizations.                                                                                                                             | None listed                                          |
| Create Many Organizations                                             | Accepts an array of up to 100 organization objects.                                                                                                                        | None listed                                          |
| Create Or Update Organization                                         | Creates an organization if it doesn't already exist, or updates an existing organization.                                                                                  | None listed                                          |
| Bulk Delete Organizations                                             | Accepts a comma-separated list of up to 100 organization ids or external ids.                                                                                              | None listed                                          |
| Search Organizations                                                  | Returns an array of organizations matching the criteria.                                                                                                                   | None listed                                          |
| Show Many Organizations                                               | Accepts a comma-separated list of up to 100 organization ids or external ids.                                                                                              | None listed                                          |
| Update Many Organizations                                             | Bulk or batch updates up to 100 organizations.                                                                                                                             | None listed                                          |
| List Ticket Problems                                                  | The response is always ordered by updated\_at in descending order                                                                                                          | None listed                                          |
| Autocomplete Problems                                                 | Returns tickets whose type is "problem" and whose subject contains the string specified in the text parameter.                                                             | None listed                                          |
| Bulk Unregister Push Notification Devices                             | Unregisters the mobile devices that are receiving push notifications.                                                                                                      | None listed                                          |
| List Queues                                                           | Returns all active queues for an account.                                                                                                                                  | None listed                                          |
| Create Queue                                                          | Creates a queue.                                                                                                                                                           | None listed                                          |
| Delete Queue                                                          | Deletes the queue and related records.                                                                                                                                     | None listed                                          |
| Show Queue                                                            | Returns a queue for the given queue id.                                                                                                                                    | None listed                                          |
| Update Queue                                                          | Updates the queue definition for a given queue id.                                                                                                                         | None listed                                          |
| List Queue Definitions                                                | Returns the definitions of the queues and the definitions of the conditions under which a queue can execute.                                                               | None listed                                          |
| Reorder Queues                                                        | Alters the evaluation order of OCR queues in the account.                                                                                                                  | None listed                                          |
| List Support Addresses                                                | Lists all the support addresses for the account.                                                                                                                           | None listed                                          |
| Create Support Address                                                | Adds a Zendesk or external support address to your account.                                                                                                                | None listed                                          |
| Delete Support Address                                                | Deletes a support address.                                                                                                                                                 | None listed                                          |
| Show Support Address                                                  | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Update Support Address                                                | Updates an existing support address for your account.                                                                                                                      | None listed                                          |
| Verify Support Address Forwarding                                     | Sends a test email to the specified support address to verify that email forwarding for the address works.                                                                 | None listed                                          |
| Filter Definitions                                                    | Returns filter definitions based on the given target type.                                                                                                                 | Target Type                                          |
| List Requests                                                         | Allowed for: End Users.                                                                                                                                                    | None listed                                          |
| Create Request                                                        | Accepts a request object that sets one or more properties.                                                                                                                 | None listed                                          |
| Show Request                                                          | Allowed for: End Users.                                                                                                                                                    | None listed                                          |
| Update Request                                                        | Updates a request with a comment or collaborators (cc's).                                                                                                                  | None listed                                          |
| Listing Comments                                                      | Allowed for: End Users.                                                                                                                                                    | Request Id                                           |
| Getting Comments                                                      | Allowed for: End Users.                                                                                                                                                    | None listed                                          |
| Search Requests                                                       | Examples:                                                                                                                                                                  | None listed                                          |
| List Resource Collections                                             | Lists resource collections for the account.                                                                                                                                | None listed                                          |
| Create Resource Collection                                            | Creates a resource collection from a provided payload object.                                                                                                              | None listed                                          |
| Delete Resource Collection                                            | Deletes a specified resource collection.                                                                                                                                   | None listed                                          |
| Show Resource Collection                                              | Retrieves details for a specified resource collection.                                                                                                                     | None listed                                          |
| Update Resource Collection                                            | Updates a resource collection using a provided payload object.                                                                                                             | None listed                                          |
| List Agent Attribute Values                                           | Returns an attribute value.                                                                                                                                                | None listed                                          |
| Set Agent Attribute Values                                            | Adds the specified attributes if no attributes exists, or replaces all existing attributes with the specified attributes.                                                  | None listed                                          |
| List Attribute Values For Many Agents                                 | Accepts a comma-separated list of up to 100 agent ids and returns attribute values for each agent in the list.                                                             | Filter\[Agent Ids]                                   |
| Bulk Set Agent Attribute Values Job                                   | Adds, replaces or removes multiple attributes for up to 100 agents.                                                                                                        | None listed                                          |
| List Account Attributes                                               | Returns a list of attributes for the account.                                                                                                                              | None listed                                          |
| Create Attribute                                                      | Creates an attribute.                                                                                                                                                      | None listed                                          |
| Delete Attribute                                                      | Deletes an attribute.                                                                                                                                                      | None listed                                          |
| Show Attribute                                                        | Returns an attribute.                                                                                                                                                      | None listed                                          |
| Update Attribute                                                      | Updates an attribute.                                                                                                                                                      | None listed                                          |
| List Attribute Values For An Attribute                                | Returns a list of attribute values for a provided attribute.                                                                                                               | None listed                                          |
| Create Attribute Value                                                | Creates an attribute value.                                                                                                                                                | None listed                                          |
| Delete Attribute Value                                                | Deletes an attribute value.                                                                                                                                                | None listed                                          |
| Show Attribute Value                                                  | Returns an attribute value.                                                                                                                                                | None listed                                          |
| Update Attribute Value                                                | Updates the name and ticket conditions of a skill.                                                                                                                         | None listed                                          |
| List Routing Attribute Definitions                                    | Returns the condition definitions that can be configured to apply attributes to a ticket.                                                                                  | None listed                                          |
| List Tickets Fulfilled By A User                                      | Returns a list of ticket ids that contain attributes matching the current user's attributes.                                                                               | Ticket Ids                                           |
| List Ticket Attribute Values                                          | Returns a list of attributes values for the ticket.                                                                                                                        | None listed                                          |
| Set Ticket Attribute Values                                           | Adds the specified attributes if no attributes exists, or replaces all existing attributes with the specified attributes.                                                  | None listed                                          |
| List Satisfaction Ratings                                             | List Zendesk satisfaction ratings (CSAT), optionally filtered by score and time window.                                                                                    | None listed                                          |
| Show Satisfaction Rating                                              | Returns a specific satisfaction rating.                                                                                                                                    | Satisfaction Rating Id                               |
| Count Satisfaction Ratings                                            | Returns an approximate count of satisfaction ratings in the account.                                                                                                       | None listed                                          |
| List Reasons For Satisfaction Rating                                  | List all reasons for an account                                                                                                                                            | None listed                                          |
| Show Reason For Satisfaction Rating                                   | Allowed for: Admins.                                                                                                                                                       | Satisfaction Reason Id                               |
| List Search Results                                                   | Returns the search results.                                                                                                                                                | Query                                                |
| Show Results Count                                                    | Returns the number of items matching the query rather than the items.                                                                                                      | Query                                                |
| Export Search Results                                                 | Exports a set of results.                                                                                                                                                  | Query                                                |
| List Sessions                                                         | If authenticated as an admin, returns all the account's sessions.                                                                                                          | None listed                                          |
| List Sharing Agreements                                               | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Create Sharing Agreement                                              | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Delete A Sharing Agreement                                            | Deletes a sharing agreement.                                                                                                                                               | None listed                                          |
| Show A Sharing Agreement                                              | Returns a sharing agreement for your account.                                                                                                                              | None listed                                          |
| Update A Sharing Agreement                                            | Returns an updated sharing agreement.                                                                                                                                      | None listed                                          |
| Record A New Skip For The Current User                                | Record a new ticket skip for the current user.                                                                                                                             | None listed                                          |
| List Sla Policies                                                     | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Create Sla Policy                                                     | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Delete Sla Policy                                                     | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Show Sla Policy                                                       | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Update Sla Policy                                                     | Updates the specified policy.                                                                                                                                              | None listed                                          |
| Retrieve SLA Policy Filter Definition Items                           | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Reorder Sla Policies                                                  | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| List Suspended Tickets                                                | Allowed for: Admins and agents in custom roles with permission to manage suspended tickets on Enterprise plans, Unrestricted agents on all other plans.                    | None listed                                          |
| Delete Suspended Ticket                                               | Allowed for: Unrestricted agents.                                                                                                                                          | Id                                                   |
| Show Suspended Ticket                                                 | Allowed for: Admins and agents in custom roles with permission to manage suspended tickets on Enterprise plans, Unrestricted agents on all other plans.                    | Id                                                   |
| Recover Suspended Ticket                                              | Note: During recovery, the API sets the requester to the authenticated agent who called the API, not the original requester.                                               | Id                                                   |
| Suspended Ticket Attachments                                          | Makes copies of any attachments on a suspended ticket and returns them as attachment tokens.                                                                               | None listed                                          |
| Delete Multiple Suspended Tickets                                     | Accepts up to 100 ids (the auto-generated id, not the ticket id.)                                                                                                          | None listed                                          |
| Export Suspended Tickets                                              | Exports a list of suspended tickets for the Zendesk Support instance.                                                                                                      | None listed                                          |
| Recover Multiple Suspended Tickets                                    | Accepts up to 100 ids (the auto-generated id, not the ticket id.) Note that suspended tickets that fail to be recovered are still included in the response.                | None listed                                          |
| List Tags                                                             | Lists up to the 20,000 most popular tags in the last 60 days, in decreasing popularity.                                                                                    | None listed                                          |
| Count Tags                                                            | Returns an approximate count of tags.                                                                                                                                      | None listed                                          |
| List Target Failures                                                  | Returns the 25 most recent target failures, per target.                                                                                                                    | None listed                                          |
| Show Target Failure                                                   | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| List Targets                                                          | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Create Target                                                         | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Delete Target                                                         | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Show Target                                                           | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Update Target                                                         | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| List All Ticket Audits                                                | Returns ticket audits.                                                                                                                                                     | None listed                                          |
| List Ticket Fields                                                    | Returns a list of all system and custom ticket fields in your account.                                                                                                     | None listed                                          |
| Create Ticket Field                                                   | Creates any of the following custom field types:                                                                                                                           | None listed                                          |
| Delete Ticket Field                                                   | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Show Ticket Field                                                     | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Update Ticket Field                                                   | You can also use the update endpoint to add, update, or remove options in a drop-down custom field.                                                                        | None listed                                          |
| List Ticket Field Options                                             | Returns a list of custom ticket field options for the given drop-down ticket field.                                                                                        | None listed                                          |
| Create Or Update Ticket Field Option                                  | Creates or updates an option for the given drop-down ticket field.                                                                                                         | None listed                                          |
| Delete Ticket Field Option                                            | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Show Ticket Field Option                                              | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Count Ticket Fields                                                   | Returns an approximate count of system and custom ticket fields in the account.                                                                                            | None listed                                          |
| Reorder Ticket Fields                                                 | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| List Ticket Form Statuses                                             | Fetches all of the ticket form statuses for the account.                                                                                                                   | None listed                                          |
| Show Many Ticket Form Statuses                                        | Fetches all of the ticket form statuses specified by a comma separated list of ids.                                                                                        | Ids                                                  |
| List Ticket Forms                                                     | Returns a list of all ticket forms for your account if accessed as an admin or agent.                                                                                      | None listed                                          |
| Create Ticket Form                                                    | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Delete Ticket Form                                                    | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Show Ticket Form                                                      | Allowed for: Admins, Agents, and End Users.                                                                                                                                | None listed                                          |
| Update Ticket Form                                                    | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Clone An Already Existing Ticket Form                                 | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Delete Ticket Form Statuses                                           | Deletes all of of the ticket form statuses by id.                                                                                                                          | None listed                                          |
| List Ticket Form Statuses Of A Ticket Form                            | Fetches all of the associated ticket form statuses of a ticket form.                                                                                                       | None listed                                          |
| Create Ticket Form Statuses                                           | Creates one or many ticket form status associations                                                                                                                        | None listed                                          |
| Bulk Update Ticket Form Statuses Of A Ticket Form                     | Updates or deletes ticket form status associations.                                                                                                                        | None listed                                          |
| Delete Ticket Form Status By Id                                       | Deletes a ticket form status by id.                                                                                                                                        | None listed                                          |
| Update Ticket Form Status By Id                                       | Updates or deletes ticket form status association by id.                                                                                                                   | None listed                                          |
| Reorder Ticket Forms                                                  | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Show Many Ticket Forms                                                | Takes an ids query parameter that accepts a comma-separated list of up to 100 ticket form ids.                                                                             | Ids                                                  |
| List Ticket Metrics                                                   | Returns a list of tickets with their metrics.                                                                                                                              | None listed                                          |
| Get Ticket Metrics                                                    | Retrieve performance metrics for a single Zendesk ticket: reopens, replies, first-reply time, resolution time, and wait-time breakdowns.                                   | Ticket (select recent or paste URL/ID)               |
| List Tickets                                                          | List Zendesk tickets, optionally sorted.                                                                                                                                   | None listed                                          |
| Create Ticket                                                         | Create a Zendesk ticket from flow inputs.                                                                                                                                  | Comment / Body                                       |
| Delete Ticket                                                         | Allowed for: Admins, Agents with permission to delete tickets.                                                                                                             | Ticket Id                                            |
| Show Ticket                                                           | Retrieve a Zendesk ticket by its numeric ID.                                                                                                                               | Ticket (select recent or paste URL/ID)               |
| Update Ticket                                                         | Update fields on a Zendesk ticket: status, priority, type, assignee, group, tag deltas, and custom fields.                                                                 | Ticket (select recent or paste URL/ID)               |
| List Audits For A Ticket                                              | Lists the audits for a specified ticket.                                                                                                                                   | None listed                                          |
| Show Audit                                                            | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Change A Comment From Public To Private                               | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Count Audits For A Ticket                                             | Returns an approximate count of audits for a specified ticket.                                                                                                             | None listed                                          |
| List Collaborators For A Ticket                                       | Allowed for: Agents.                                                                                                                                                       | Ticket Id                                            |
| List Ticket Comments                                                  | Read the full comment thread on a Zendesk ticket.                                                                                                                          | Ticket (select recent or paste URL/ID)               |
| Redact Comment Attachment                                             | Redaction allows you to permanently remove attachments from an existing comment on a ticket.                                                                               | None listed                                          |
| Make Comment Private                                                  | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Redact String In Comment                                              | Permanently removes words or strings from a ticket comment.                                                                                                                | None listed                                          |
| Count Ticket Comments                                                 | Returns an approximate count of the comments added to the ticket.                                                                                                          | Ticket Id                                            |
| List Email Ccs For A Ticket                                           | Returns any users cc'd on the ticket.                                                                                                                                      | Ticket Id                                            |
| List Followers For A Ticket                                           | Returns any users who follow the ticket.                                                                                                                                   | Ticket Id                                            |
| List Ticket Incidents                                                 | Allowed for: Agents.                                                                                                                                                       | Ticket Id                                            |
| Show Ticket After Changes                                             | Returns the full ticket object as it would be after applying the macro to the ticket.                                                                                      | None listed                                          |
| Mark Ticket As Spam And Suspend Requester                             | Allowed for: Agents.                                                                                                                                                       | Ticket Id                                            |
| Merge Tickets Into Target Ticket                                      | Merges one or more tickets into the ticket with the specified id.                                                                                                          | Ticket Id                                            |
| Ticket Related Information                                            | The request returns a data object with the following properties:                                                                                                           | Ticket Id                                            |
| Create A Satisfaction Rating                                          | Creates a CSAT rating for a solved ticket, or for a ticket that was previously solved and then reopened.                                                                   | None listed                                          |
| Remove Tags                                                           | You can also delete tags from multiple tickets with the Update Many Tickets endpoint.                                                                                      | None listed                                          |
| List Resource Tags                                                    | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Set Tags                                                              | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Add Tags                                                              | You can also add tags to multiple tickets with the Update Many Tickets endpoint.                                                                                           | None listed                                          |
| Count Tickets                                                         | Returns an approximate count of tickets in the account.                                                                                                                    | None listed                                          |
| Create Many Tickets                                                   | Accepts an array of up to 100 ticket objects.                                                                                                                              | None listed                                          |
| Bulk Delete Tickets                                                   | Accepts a comma-separated list of up to 100 ticket ids.                                                                                                                    | Ids                                                  |
| Bulk Mark Tickets As Spam                                             | Accepts a comma-separated list of up to 100 ticket ids.                                                                                                                    | Ids                                                  |
| Show Multiple Tickets                                                 | Accepts a comma-separated list of ticket ids to return.                                                                                                                    | Ids                                                  |
| Update Many Tickets                                                   | Accepts an array of up to 100 ticket objects, or a comma-separated list of up to 100 ticket ids.                                                                           | None listed                                          |
| List Ticket Trigger Categories                                        | Returns all the ticket trigger categories in the account.                                                                                                                  | None listed                                          |
| Create Ticket Trigger Category                                        | Creates a ticket trigger category.                                                                                                                                         | None listed                                          |
| Delete Ticket Trigger Category                                        | Deletes the ticket trigger category with the specified ID.                                                                                                                 | Trigger Category Id                                  |
| Show Ticket Trigger Category                                          | Returns the ticket trigger category with the specified ID.                                                                                                                 | Trigger Category Id                                  |
| Update Ticket Trigger Category                                        | Updates the ticket trigger category with the specified ID.                                                                                                                 | Trigger Category Id                                  |
| Create Batch Job For Ticket Trigger Categories                        | Creates a job that performs a batch operation for the given ticket trigger categories.                                                                                     | None listed                                          |
| List Ticket Triggers                                                  | Lists all ticket triggers for the current account.                                                                                                                         | None listed                                          |
| Create Trigger                                                        | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Delete Ticket Trigger                                                 | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Show Ticket Trigger                                                   | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Update Ticket Trigger                                                 | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| List Ticket Trigger Revisions                                         | List the revisions associated with a ticket trigger.                                                                                                                       | None listed                                          |
| Show Ticket Trigger Revision                                          | Fetches a revision associated with a ticket trigger.                                                                                                                       | None listed                                          |
| List Active Ticket Triggers                                           | Lists all active ticket triggers.                                                                                                                                          | None listed                                          |
| List Ticket Trigger Action And Condition Definitions                  | Returns the definitions of the actions a ticket trigger can perform and the definitions of the conditions under which a ticket trigger can execute.                        | None listed                                          |
| Bulk Delete Ticket Triggers                                           | Deletes the ticket triggers corresponding to the provided comma-separated list of IDs.                                                                                     | None listed                                          |
| Reorder Ticket Triggers                                               | Alters the firing order of ticket triggers in the account.                                                                                                                 | None listed                                          |
| Search Ticket Triggers                                                | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Update Many Ticket Triggers                                           | Updates the position or the active status of multiple ticket triggers.                                                                                                     | None listed                                          |
| Upload Files                                                          | Uploads a file that can be attached to a ticket comment.                                                                                                                   | None listed                                          |
| Delete Upload                                                         | Allowed for: End Users.                                                                                                                                                    | Token                                                |
| List User Fields                                                      | Returns a list of custom user fields in your account.                                                                                                                      | None listed                                          |
| Create User Field                                                     | Creates any of the following custom field types: See About custom field types in Zendesk help.                                                                             | None listed                                          |
| Delete User Field                                                     | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Show User Field                                                       | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Update User Field                                                     | Dropdown and multiselect fields return an array of custom\_field\_options which specify the name, value, and order of the list of dropdown or multiselect options.         | None listed                                          |
| List User Field Options                                               | Returns a list of custom user field options for the given dropdown user field.                                                                                             | None listed                                          |
| Create Or Update A User Field Option                                  | Creates a new option or updates an existing option for the given drop-down user field.                                                                                     | None listed                                          |
| Delete User Field Option                                              | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Show A User Field Option                                              | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Reorder User Field                                                    | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| List Users                                                            | List Zendesk users, optionally filtered by role (end-user, agent, admin).                                                                                                  | None listed                                          |
| Create User                                                           | Use this tool to post create user                                                                                                                                          | None listed                                          |
| Delete User                                                           | Deletes the user and associated records from the account.                                                                                                                  | None listed                                          |
| Show User                                                             | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Update User                                                           | Use this tool to put update user                                                                                                                                           | None listed                                          |
| Show Compliance Deletion Statuses                                     | Returns the GDPR status for each user per area of compliance.                                                                                                              | User Id                                              |
| Set Group Membership As Default                                       | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| List Identities                                                       | Returns a list of identities for the given user.                                                                                                                           | None listed                                          |
| Create Identity                                                       | Adds an identity to a user's profile.                                                                                                                                      | None listed                                          |
| Delete Identity                                                       | Deletes the identity for a given user.                                                                                                                                     | None listed                                          |
| Show Identity                                                         | Shows the identity with the given id for a given user.                                                                                                                     | None listed                                          |
| Update Identity                                                       | This endpoint allows you to: You can't change an identity's primary attribute with this endpoint.                                                                          | None listed                                          |
| Make Identity Primary                                                 | Sets the specified identity as primary.                                                                                                                                    | None listed                                          |
| Request User Verification                                             | Sends the user a verification email with a link to verify ownership of the email address.                                                                                  | None listed                                          |
| Verify Identity                                                       | Sets the specified identity as verified.                                                                                                                                   | None listed                                          |
| Merge End Users                                                       | Merges the end user specified in the path parameter into the existing end user specified in the request body.                                                              | None listed                                          |
| Set Organization Membership As Default                                | Sets the default organization membership of a given user.                                                                                                                  | None listed                                          |
| Unassign Organization                                                 | Immediately removes a user from an organization and schedules a job to unassign all working tickets currently assigned to the user and organization combination.           | None listed                                          |
| Set Organization As Default                                           | Sets the default organization membership of a given user.                                                                                                                  | None listed                                          |
| Set A User\&#39;S Password                                            | An admin can set a user's password only if the setting is enabled in Zendesk Support under Settings > Security > Global.                                                   | None listed                                          |
| Change Your Password                                                  | You can only change your own password.                                                                                                                                     | None listed                                          |
| List Password Requirements                                            | Allowed for: Agents, End Users.                                                                                                                                            | None listed                                          |
| Show User Related Information                                         | Use this tool to get show user related information                                                                                                                         | None listed                                          |
| Bulk Delete Sessions                                                  | Deletes all the sessions for a user.                                                                                                                                       | None listed                                          |
| Delete Session                                                        | Allowed for: Admins, Agents, End users.                                                                                                                                    | None listed                                          |
| Show Session                                                          | Allowed for: Admins, Agents, End users.                                                                                                                                    | None listed                                          |
| List Ticket Skips                                                     | Archived tickets are not included in the response.                                                                                                                         | None listed                                          |
| Autocomplete Users                                                    | Returns an array of users whose name starts with the value specified in the name parameter.                                                                                | Name                                                 |
| Count Users                                                           | Returns an approximate count of users.                                                                                                                                     | None listed                                          |
| Create Many Users                                                     | Accepts an array of up to 100 user objects.                                                                                                                                | None listed                                          |
| Create Or Update User                                                 | Creates a user if the user does not already exist, or updates an existing user identified by e-mail address or external ID.                                                | None listed                                          |
| Create Or Update Many Users                                           | Accepts an array of up to 100 user objects.                                                                                                                                | None listed                                          |
| Bulk Delete Users                                                     | Accepts a comma-separated list of up to 100 user ids.                                                                                                                      | None listed                                          |
| Logout Many Users                                                     | Accepts a comma-separated list of up to 100 user ids.                                                                                                                      | None listed                                          |
| Show Self                                                             | The endpoint returns user information and an authenticity\_token.                                                                                                          | None listed                                          |
| Delete The Authenticated Session                                      | Deletes the current session.                                                                                                                                               | None listed                                          |
| Show The Currently Authenticated Session                              | Allowed for: Admins, Agents, End users.                                                                                                                                    | None listed                                          |
| Renew The Current Session                                             | Allowed for: Admins, Agents, End users.                                                                                                                                    | None listed                                          |
| Request User Create                                                   | Sends the owner a reminder email to update their subscription so more agents can be created.                                                                               | None listed                                          |
| Search Users                                                          | Returns an array of users who meet the search criteria.                                                                                                                    | None listed                                          |
| Show Many Users                                                       | Accepts a comma-separated list of up to 100 user ids or external ids.                                                                                                      | None listed                                          |
| Update Many Users                                                     | Use this tool to put update many users                                                                                                                                     | None listed                                          |
| List Views                                                            | Lists shared and personal views available to the current user.                                                                                                             | None listed                                          |
| Create View                                                           | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Delete View                                                           | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Show View                                                             | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Update View                                                           | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| Count Tickets In View                                                 | Returns the ticket count for a single view.                                                                                                                                | None listed                                          |
| Execute View                                                          | Returns the column titles and the rows of the specified view.                                                                                                              | View Id                                              |
| Export View                                                           | Returns the csv attachment of the specified view if possible.                                                                                                              | None listed                                          |
| List Tickets From A View                                              | Allowed for: Agents.                                                                                                                                                       | View Id                                              |
| List Active Views                                                     | Lists active shared and personal views available to the current user.                                                                                                      | None listed                                          |
| List Views - Compact                                                  | A compacted list of shared and personal views available to the current user.                                                                                               | None listed                                          |
| Count Views                                                           | Returns an approximate count of shared and personal views available to the current user.                                                                                   | None listed                                          |
| Count Tickets In Views                                                | Returns the ticket count of each view in a list of views.                                                                                                                  | Ids                                                  |
| Bulk Delete Views                                                     | Deletes the views corresponding to the provided list of IDs.                                                                                                               | Ids                                                  |
| Preview Views                                                         | You can preview views by constructing the conditions in the proper format and nesting them under the view property.                                                        | None listed                                          |
| Preview Ticket Count                                                  | Returns the ticket count for a single preview.                                                                                                                             | None listed                                          |
| Search Views                                                          | Allowed for: Agents.                                                                                                                                                       | Query                                                |
| List Views By Id                                                      | Allowed for: Agents.                                                                                                                                                       | Ids                                                  |
| Update Many Views                                                     | Allowed for: Agents.                                                                                                                                                       | None listed                                          |
| List Workspaces                                                       | Allowed for: Admins, Agents.                                                                                                                                               | None listed                                          |
| Create Workspace                                                      | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Delete Workspace                                                      | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Show Workspace                                                        | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Update Workspace                                                      | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Bulk Delete Workspaces                                                | Allowed for: Admins.                                                                                                                                                       | Ids                                                  |
| Reorder Workspaces                                                    | Allowed for: Admins.                                                                                                                                                       | None listed                                          |
| Create Token For Grant Type                                           | Returns an OAuth access token in exchange for an authorization code valid for 120 seconds.                                                                                 | None listed                                          |
| Search Articles                                                       | Search Zendesk Help Center articles by query, with optional filters by locale, category, section, and labels.                                                              | Query                                                |
| Search Tickets                                                        | Search Zendesk tickets by free-text and discrete filters (status, priority, assignee, group, tags, dates).                                                                 | None listed                                          |
| Add Comment                                                           | Add a comment to a Zendesk ticket.                                                                                                                                         | Ticket (select recent or paste URL/ID), Comment Body |

## Triggers

| Trigger           | Event                                                                       |
| ----------------- | --------------------------------------------------------------------------- |
| On Ticket Created | Trigger a workflow execution every time a new ticket is created in Zendesk. |

## Important behavior

If an operation is denied, check the connection’s granted permissions and the account’s access in the provider. Reauthorize the connection when it needs additional permissions.

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# 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://docs.stackai.com/integrations/catalog/zendesk.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.
