Zendesk

Zendesk Trigger Categories API

The Trigger Categories API from Zendesk — 3 operation(s) for trigger categories.

Documentation GitHub OpenAPI

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v2/trigger_categories List ticket trigger categories · Zendesk Get Api V2 Trigger_categories #

Ask an LLM

“What categories are my ticket triggers organized into?”

“Can I include rule counts when listing trigger categories?”

Tell an agent

List the ticket trigger categories sorted by {sort}.

Show the trigger categories including {include}.

POST /api/v2/trigger_categories Create a ticket trigger category · Zendesk Post Api V2 Trigger_categories #

Ask an LLM

“How do I add a new category to group my ticket triggers?”

“Can I set a category's position when I create it?”

Tell an agent

Create the trigger category {trigger_category}.

Add a new ticket trigger category named Notifications.

GET /api/v2/trigger_categories/{trigger_category_id} Show a ticket trigger category · Zendesk Get Api V2 Trigger_categories Trigger_category_id #

Ask an LLM

“Can I view a single trigger category by its ID?”

“What details are stored on one trigger category?”

Tell an agent

Show trigger category {trigger_category_id}.

Fetch the details of category {trigger_category_id}.

PATCH /api/v2/trigger_categories/{trigger_category_id} Rename or reposition a trigger category · Zendesk Patch Api V2 Trigger_categories Trigger_category_id #

Ask an LLM

“Can I rename an existing ticket trigger category?”

“Is it possible to change the position of one category?”

Tell an agent

Update trigger category {trigger_category_id} with {trigger_category}.

Rename category {trigger_category_id} to Escalations.

DELETE /api/v2/trigger_categories/{trigger_category_id} Delete a ticket trigger category · Zendesk Delete Api V2 Trigger_categories Trigger_category_id #

Ask an LLM

“Can I remove a trigger category I no longer use?”

“Which call deletes one ticket trigger category?”

Tell an agent destructive · confirm first

Delete trigger category {trigger_category_id}.

Remove the unused category {trigger_category_id}.

POST /api/v2/trigger_categories/jobs Batch update trigger categories and triggers · Zendesk Post Api V2 Trigger_categories Jobs #

Ask an LLM

“Can I reorder several trigger categories in a single job?”

“Is there a batch job for operating on many ticket trigger categories at once?”

Tell an agent

Run a batch job to reposition my trigger categories.

Apply a batch operation across several ticket trigger categories.

Documentation

https://developer.zendesk.com/api-reference/ticketing/introduction/

https://developer.zendesk.com/api-reference/ticketing/targets/targets/

https://developer.zendesk.com/api-reference/sales-crm/resources/account/

https://developer.zendesk.com/api-reference/ticketing/tickets/activity_stream/

https://developer.zendesk.com/api-reference/ticketing/account-configuration/channel_framework/

https://developer.zendesk.com/api-reference/ticketing/tickets/ticket-attachments/

https://developer.zendesk.com/api-reference/ticketing/account-configuration/audit_logs/

https://developer.zendesk.com/api-reference/ticketing/organizations/organizations/

https://developer.zendesk.com/api-reference/ticketing/business-rules/automations/

https://developer.zendesk.com/api-reference/ticketing/ticket-management/bookmarks/

https://developer.zendesk.com/api-reference/ticketing/account-configuration/brand_agents/

https://developer.zendesk.com/api-reference/ticketing/account-configuration/brands/

https://developer.zendesk.com/api-reference/live-chat/chat-api/chats/

https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_comments/

https://developer.zendesk.com/api-reference/custom-data/introduction/

https://developer.zendesk.com/api-reference/ticketing/account-configuration/custom_roles/

https://developer.zendesk.com/api-reference/ticketing/tickets/custom_ticket_statuses/

https://developer.zendesk.com/api-reference/ticketing/tickets/tickets/

https://developer.zendesk.com/api-reference/ticketing/users/users/

https://developer.zendesk.com/api-reference/ticketing/business-rules/deletion_schedules/

https://developer.zendesk.com/api-reference/ticketing/ticket-management/dynamic_content/

https://developer.zendesk.com/api-reference/ticketing/tickets/email_notifications/

https://developer.zendesk.com/api-reference/ticketing/groups/group_memberships/

https://developer.zendesk.com/api-reference/ticketing/business-rules/group_sla_policies/

https://developer.zendesk.com/api-reference/ticketing/groups/groups/

https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_import/

https://developer.zendesk.com/api-reference/ticketing/ticket-management/incremental_exports/

https://developer.zendesk.com/api-reference/ticketing/ticket-management/job_statuses/

https://developer.zendesk.com/api-reference/ticketing/account-configuration/locales/

https://developer.zendesk.com/api-reference/ticketing/business-rules/macros/

https://developer.zendesk.com/api-reference/ticketing/oauth/oauth_tokens/

https://developer.zendesk.com/api-reference/ticketing/organizations/organization_fields/

https://developer.zendesk.com/api-reference/ticketing/organizations/organization_memberships/

https://developer.zendesk.com/api-reference/ticketing/organizations/organization_subscriptions/

https://developer.zendesk.com/api-reference/ticketing/account-configuration/push_notification_devices/

https://developer.zendesk.com/api-reference/agent-availability/omnichannel_routing_queues/omnichannel_routing_queues/

https://developer.zendesk.com/api-reference/ticketing/account-configuration/support_addresses/

https://developer.zendesk.com/api-reference/ticketing/lookup_relationships/lookup_relationships/

https://developer.zendesk.com/api-reference/ticketing/tickets/ticket-requests/

https://developer.zendesk.com/api-reference/ticketing/ticket-management/resource_collections/

https://developer.zendesk.com/api-reference/ticketing/ticket-management/skill_based_routing/

https://developer.zendesk.com/api-reference/ticketing/ticket-management/satisfaction_ratings/

https://developer.zendesk.com/api-reference/ticketing/ticket-management/satisfaction_reasons/

https://developer.zendesk.com/api-reference/ticketing/ticket-management/search/

https://developer.zendesk.com/api-reference/ticketing/account-configuration/sessions/

https://developer.zendesk.com/api-reference/ticketing/tickets/sharing_agreements/

https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_skips/

https://developer.zendesk.com/api-reference/ticketing/business-rules/sla_policies/

https://developer.zendesk.com/api-reference/ticketing/tickets/suspended_tickets/

https://developer.zendesk.com/api-reference/ticketing/ticket-management/tags/

https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_audits/

https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_fields/

https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_form_statuses/

https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_forms/

https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_metrics/

https://developer.zendesk.com/api-reference/ticketing/business-rules/triggers/

https://developer.zendesk.com/api-reference/ticketing/business-rules/views/

https://developer.zendesk.com/api-reference/ticketing/ticket-management/workspaces/

Specifications

https://raw.githubusercontent.com/api-evangelist/zendesk/refs/heads/main/openapi/zendesk-trigger-categories-api-openapi.yml

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/zendesk/refs/heads/main/json-schema/zendesk-ticket-schema.json

https://raw.githubusercontent.com/api-evangelist/zendesk/refs/heads/main/json-schema/zendesk-user-schema.json

Other Resources

https://raw.githubusercontent.com/api-evangelist/zendesk/refs/heads/main/json-ld/zendesk-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/zendesk:zendesk-trigger-categories-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  version: '1.0'
  title: Zendesk Trigger Categories API
  description: Needs a description.
tags:
- name: Trigger Categories
paths:
  /api/v2/trigger_categories:
    get:
      operationId: ListTriggerCategories
      tags:
      - Trigger Categories
      summary: Zendesk Get Api V2 Trigger_categories
      description: 'Returns all the ticket trigger categories in the account.


        #### Pagination


        * Cursor pagination (recommended)

        * Offset pagination


        See Pagination.'
      parameters:
      - name: page
        in: query
        description: Pagination parameters
        style: deepObject
        explode: true
        schema:
          type: object
          properties:
            after:
              type: string
            before:
              type: string
            size:
              type: integer
        example:
          after: eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9
          before: eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9
          size: 50
      - name: sort
        in: query
        description: Sort parameters
        schema:
          type: string
          enum:
          - position
          - -position
          - name
          - -name
          - created_at
          - -created_at
          - updated_at
          - -updated_at
      - name: include
        in: query
        description: Allowed sideloads
        schema:
          type: string
          enum:
          - rule_counts
      responses:
        '200':
          description: A paged array of ticket trigger categories
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/TriggerCategoriesResponse'
                - $ref: '#/components/schemas/Pagination'
              example:
                links:
                  next: https://{subdomain}.zendesk.com/api/v2/trigger_categories.json?include=rule_counts&page[after]=eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9&page[size]=2&sort=position
                  prev: https://{subdomain}.zendesk.com/api/v2/trigger_categories.json?include=rule_counts&page[before]=eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9&page[size]=2&sort=position
                meta:
                  after_cursor: eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9
                  before_cursor: eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9
                  has_more: true
                trigger_categories:
                - created_at: '2020-07-17T01:30:07Z'
                  id: '10001'
                  name: Email Triggers
                  position: 0
                  updated_at: '2020-07-17T01:30:07Z'
                - created_at: '2020-07-17T01:30:07Z'
                  id: '10002'
                  name: SMS Triggers
                  position: 1
                  updated_at: '2020-07-17T01:30:07Z'
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
              example:
                errors:
                - code: InvalidPaginationParameter
                  title: page[after] is not valid
        '403':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
              example:
                errors:
                - code: TriggerCategoriesNotEnabled
                  title: Ticket trigger categories are not enabled for your account
    post:
      operationId: CreateTriggerCategory
      tags:
      - Trigger Categories
      summary: Zendesk Post Api V2 Trigger_categories
      description: Creates a ticket trigger category.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                trigger_category:
                  allOf:
                  - $ref: '#/components/schemas/TriggerCategoryRequest'
                  - $ref: '#/components/schemas/TriggerCategoryRequestRequired'
            example:
              trigger_category:
                name: All Notification Triggers
                position: 0
      responses:
        '200':
          description: The created ticket trigger category
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TriggerCategoryResponse'
              example:
                trigger_category:
                  created_at: '2020-07-17T01:30:07Z'
                  id: '10001'
                  name: All Notification Triggers
                  position: 0
                  updated_at: '2020-07-17T01:30:07Z'
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
              example:
                errors:
                - code: InvalidTriggerCategory
                  title: Name cannot be blank
        '403':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
              example:
                errors:
                - code: TriggerCategoriesNotEnabled
                  title: Ticket trigger categories are not enabled for your account
                - code: ProductLimitExceeded
                  title: Your account has reached the limit of 500 ticket trigger categories.
  /api/v2/trigger_categories/{trigger_category_id}:
    get:
      operationId: ShowTriggerCategoryById
      tags:
      - Trigger Categories
      summary: Zendesk Get Api V2 Trigger_categories Trigger_category_id
      description: Returns the ticket trigger category with the specified ID.
      parameters:
      - name: trigger_category_id
        in: path
        description: The id of the ticket trigger category to retrieve
        required: true
        schema:
          type: string
        example: '10001'
      responses:
        '200':
          description: The requested ticket trigger category
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TriggerCategoryResponse'
              example:
                trigger_category:
                  created_at: '2020-07-17T01:30:07Z'
                  id: '10001'
                  name: All Notification Triggers
                  position: 0
                  updated_at: '2020-07-17T01:30:07Z'
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
              example:
                errors:
                - code: TriggerCategoryNotFound
                  title: Category can’t be found. Check the ID and try again.
    patch:
      operationId: UpdateTriggerCategory
      tags:
      - Trigger Categories
      summary: Zendesk Patch Api V2 Trigger_categories Trigger_category_id
      description: Updates the ticket trigger category with the specified ID.
      parameters:
      - name: trigger_category_id
        in: path
        description: The id of the ticket trigger category to update
        required: true
        schema:
          type: string
        example: '10001'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                trigger_category:
                  $ref: '#/components/schemas/TriggerCategoryRequest'
            example:
              trigger_category:
                name: All Notification Triggers Updated
                position: 10
      responses:
        '200':
          description: The updated trigger category
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TriggerCategoryResponse'
              example:
                trigger_category:
                  created_at: '2020-07-17T01:30:07Z'
                  id: '10001'
                  name: All Notification Triggers Updated
                  position: 10
                  updated_at: '2020-07-18T05:23:32Z'
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
              example:
                errors:
                - code: InvalidTriggerCategory
                  title: Name cannot be blank
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
              example:
                errors:
                - code: TriggerCategoryNotFound
                  title: Category can’t be found. Check the ID and try again.
    delete:
      operationId: DeleteTriggerCategory
      tags:
      - Trigger Categories
      summary: Zendesk Delete Api V2 Trigger_categories Trigger_category_id
      description: Deletes the ticket trigger category with the specified ID.
      parameters:
      - name: trigger_category_id
        in: path
        description: The id of the ticket trigger category to delete
        required: true
        schema:
          type: string
        example: '10001'
      responses:
        '204':
          description: No content
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
              example:
                errors:
                - code: TriggerCategoryNotEmpty
                  title: A category with active ticket triggers cannot be deleted.
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
              example:
                errors:
                - code: TriggerCategoryNotFound
                  title: Category can’t be found. Check the ID and try again.
  /api/v2/trigger_categories/jobs:
    post:
      operationId: BatchOperateTriggerCategories
      tags:
      - Trigger Categories
      summary: Zendesk Post Api V2 Trigger_categories Jobs
      description: Creates a job that performs a batch operation for the given ticket trigger categories.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchJobRequest'
            example:
              job:
                action: patch
                items:
                  trigger_categories:
                  - id: '10001'
                    position: 0
                  - id: '10002'
                    position: 1
                  triggers:
                  - active: false
                    category_id: '10001'
                    id: '10011'
                    position: 10
                  - active: true
                    category_id: '10002'
                    id: '10012'
                    position: 1
      responses:
        '200':
          description: The response to the batch job
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchJobResponse'
              example:
                results:
                  trigger_categories:
                  - created_at: '2020-07-18T01:24:53Z'
                    id: '10001'
                    name: Notifications
                    position: 0
                    updated_at: '2020-07-20T01:30:07Z'
                  - created_at: '2020-07-17T06:31:12Z'
                    id: '10002'
                    name: Apply Tags
                    position: 1
                    updated_at: '2020-07-20T01:30:07Z'
                  triggers:
                  - actions:
                    - {}
                    active: true
                    conditions: {}
                    created_at: '2012-09-25T22:50:26Z'
                    description: Notify external target
                    id: 10012
                    position: 1
                    raw_title: Notify target
                    title: Notify Target
                    updated_at: '2020-07-20T01:30:07Z'
                    url: http://{subdomain}.zendesk.com/api/v2/triggers/10012.json
                  - actions:
                    - {}
                    active: false
                    conditions: {}
                    created_at: '2012-09-25T22:50:26Z'
                    description: Close and save a ticket
                    id: 10011
                    position: 10
                    raw_title: Close and Save
                    title: Close and Save
                    updated_at: '2020-07-20T01:30:07Z'
                    url: http://{subdomain}.zendesk.com/api/v2/triggers/10011.json
                status: complete
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchJobResponse'
              example:
                errors:
                - code: InvalidTrigger
                  title: category_id is not valid
                  trigger_id: '10001'
                status: failed
components:
  schemas:
    BatchJobResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/BatchErrorItem'
        results:
          type: object
          properties:
            trigger_categories:
              type: array
              items:
                $ref: '#/components/schemas/TriggerCategory'
            triggers:
              type: array
              items:
                $ref: '#/components/schemas/TriggerObject'
        status:
          type: string
          enum:
          - complete
          - failed
    TriggerCategoryResponse:
      type: object
      properties:
        trigger_category:
          $ref: '#/components/schemas/TriggerCategory'