Trigger Categories

Trigger categories allow Zendesk admins to visually group triggers and make it easier for them to organize and manage their triggers. For more information, see Creating categories to organize triggers in Zendesk help.

JSON format

Trigger Categories are represented as JSON objects with the following properties:

Name	Type	Read-only	Mandatory	Description
created_at	string	true	false
id	string	true	false
name	string	false	false
position	integer	false	false
updated_at	string	true	false

List Trigger Categories

• GET /api/v2/trigger_categories

Returns all the trigger categories in the account.

Parameters

Name	Type	In	Required	Description
include	string	Query	false	Allowed sideloads. Allowed value of "rule_counts".
page	object	Query	false	Pagination parameters
sort	string	Query	false	Sort parameters. Allowed values are "position", "-position", "name", "-name", "created_at", "-created_at", "updated_at", or "-updated_at".

Code Samples

cURL

This example provides an example query with pagination parameters with cURL.

curl -u {email}:{password} -X GET \
  --url https://{subdomain}.zendesk.com/api/v2/trigger_categories

Go

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://example.zendesk.com/api/v2/trigger_categories?include=&page=%7B%22after%22%3A%22eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9%22%2C%22before%22%3A%22eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9%22%2C%22size%22%3A50%7D&sort="
	method := "GET"
	req, err := http.NewRequest(method, url, nil)

	if err != nil {
		fmt.Println(err)
		return
	}
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "Basic <auth-value>") // Base64 encoded "username:password"

	client := &http.Client {}
	res, err := client.Do(req)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(string(body))
}

Java

import com.squareup.okhttp.*;
OkHttpClient client = new OkHttpClient();
HttpUrl.Builder urlBuilder = HttpUrl.parse("https://example.zendesk.com/api/v2/trigger_categories")
		.newBuilder()
		.addQueryParameter("include", "")
		.addQueryParameter("page", "{"after":"eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9","before":"eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9","size":50}")
		.addQueryParameter("sort", "");

Request request = new Request.Builder()
		.url(urlBuilder.build())
		.method("GET", null)
		.addHeader("Content-Type", "application/json")
		.addHeader("Authorization", Credentials.basic("your-email", "your-password"))
		.build();
Response response = client.newCall(request).execute();

JavaScript

This example provides an example query with pagination parameters in JavaScript.

fetch("https://{subdomain}.zendesk.com/api/v2/trigger_categories?include=rule_counts&page[size]=10&page[after]=eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9", {
  "method": "GET",
  "headers": {}
})
.then(response => {
  // do stuff with successful response
})
.catch(err => {
  // do stuff with failed response
});

Nodejs

var axios = require('axios');

var config = {
  method: 'GET',
  url: 'https://example.zendesk.com/api/v2/trigger_categories',
  headers: {
	'Content-Type': 'application/json',
	'Authorization': 'Basic <auth-value>', // Base64 encoded "username:password"
  },
  params: {
    'include': '',
    'page': '%7B%22after%22%3A%22eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9%22%2C%22before%22%3A%22eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9%22%2C%22size%22%3A50%7D',
    'sort': '',
  },
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests

url = "https://example.zendesk.com/api/v2/trigger_categories?include=&page=%7B%22after%22%3A%22eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9%22%2C%22before%22%3A%22eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9%22%2C%22size%22%3A50%7D&sort="
headers = {
	"Content-Type": "application/json",
}

response = requests.request(
	"GET",
	url,
	auth=('<username>', '<password>'),
	headers=headers
)

print(response.text)

Ruby

require "net/http"
uri = URI("https://example.zendesk.com/api/v2/trigger_categories")
uri.query = URI.encode_www_form("include": "", "page": "{"after":"eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9","before":"eyJvIjoiLXNjb3JlLGlkIiwidiI6ImFRSUFBQUFBQUFBQWFRMHBJUUVBQUFBQSJ9","size":50}", "sort": "")
request = Net::HTTP::Get.new(uri, "Content-Type": "application/json")
request.basic_auth "username", "password"
response = Net::HTTP.start uri.hostname, uri.port, use_ssl: true do |http|
	http.request(request)
end

Example response(s)

200 OK

// Status 200 OK

{
  "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 Bad Request

// Status 400 Bad Request

{
  "errors": [
    {
      "code": "InvalidPaginationParameter",
      "title": "page[after] is not valid"
    }
  ]
}

403 Forbidden

// Status 403 Forbidden

{
  "errors": [
    {
      "code": "TriggerCategoriesNotEnabled",
      "title": "Trigger categories are not enabled for your account"
    }
  ]
}

Create Trigger Category

• POST /api/v2/trigger_categories

Creates a trigger category.

Example body

{
  "trigger_category": {
    "name": "All Notification Triggers",
    "position": 0
  }
}

Code Samples

cURL

This example provides an example trigger category POST request with cURL.

curl -u {email}:{password} -X POST \
  --url https://{subdomain}.zendesk.com/api/v2/trigger_categories \
  -H 'content-type: application/json' \
  -d '{
  "trigger_category": {
    "name": "Example Category",
    "position": 10
  }
}'

Go

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	url := "https://example.zendesk.com/api/v2/trigger_categories"
	method := "POST"
	payload := strings.NewReader(`{
  "trigger_category": {
    "name": "All Notification Triggers",
    "position": 0
  }
}`)
	req, err := http.NewRequest(method, url, payload)

	if err != nil {
		fmt.Println(err)
		return
	}
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "Basic <auth-value>") // Base64 encoded "username:password"

	client := &http.Client {}
	res, err := client.Do(req)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(string(body))
}

Java

import com.squareup.okhttp.*;
OkHttpClient client = new OkHttpClient();
HttpUrl.Builder urlBuilder = HttpUrl.parse("https://example.zendesk.com/api/v2/trigger_categories")
		.newBuilder();
RequestBody body = RequestBody.create(MediaType.parse("application/json"),
		"""
{
  \"trigger_category\": {
    \"name\": \"All Notification Triggers\",
    \"position\": 0
  }
}""");

Request request = new Request.Builder()
		.url(urlBuilder.build())
		.method("POST", body)
		.addHeader("Content-Type", "application/json")
		.addHeader("Authorization", Credentials.basic("your-email", "your-password"))
		.build();
Response response = client.newCall(request).execute();

JavaScript

This example provides an example trigger category POST request in JavaScript.

fetch("https://{subdomain}.zendesk.com/api/v2/trigger_categories", {
  "method": "POST",
  "headers": {
    "content-type": "application/json"
  },
  "body": {
    "trigger_category": {
      "name": "Example Category",
      "position": 10
    }
  }
})
.then(response => {
  // do stuff with successful response
})
.catch(err => {
  // do stuff with failed response
});

Nodejs

var axios = require('axios');
var data = JSON.stringify({
  "trigger_category": {
    "name": "All Notification Triggers",
    "position": 0
  }
});

var config = {
  method: 'POST',
  url: 'https://example.zendesk.com/api/v2/trigger_categories',
  headers: {
	'Content-Type': 'application/json',
	'Authorization': 'Basic <auth-value>', // Base64 encoded "username:password"
  },
  data : data,
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests
import json

url = "https://example.zendesk.com/api/v2/trigger_categories"

payload = json.loads("""{
  "trigger_category": {
    "name": "All Notification Triggers",
    "position": 0
  }
}""")
headers = {
	"Content-Type": "application/json",
}

response = requests.request(
	"POST",
	url,
	auth=('<username>', '<password>'),
	headers=headers,
	json=payload
)

print(response.text)

Ruby

require "net/http"
uri = URI("https://example.zendesk.com/api/v2/trigger_categories")
request = Net::HTTP::Post.new(uri, "Content-Type": "application/json")
request.body = %q({
  "trigger_category": {
    "name": "All Notification Triggers",
    "position": 0
  }
})
request.basic_auth "username", "password"
response = Net::HTTP.start uri.hostname, uri.port, use_ssl: true do |http|
	http.request(request)
end

Example response(s)

200 OK

// Status 200 OK

{
  "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 Bad Request

// Status 400 Bad Request

{
  "errors": [
    {
      "code": "InvalidTriggerCategory",
      "title": "Name cannot be blank"
    }
  ]
}

403 Forbidden

// Status 403 Forbidden

{
  "errors": [
    {
      "code": "TriggerCategoriesNotEnabled",
      "title": "Trigger categories are not enabled for your account"
    },
    {
      "code": "ProductLimitExceeded",
      "title": "Your account has reached the limit of 500 trigger categories."
    }
  ]
}

Create Batch Job for Trigger Categories

• POST /api/v2/trigger_categories/jobs

Creates a job that performs a batch operation for the given trigger categories.

Example body

{
  "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
        }
      ]
    }
  }
}

Code Samples

cURL

This example provides an example request for batch operating on existing trigger categories with cURL.

curl -u {email}:{password} -X POST \
  --url https://{subdomain}.zendesk.com/api/v2/trigger_categories/jobs \
  -H 'content-type: application/json' \
  -d '{
  "job": {
    "action": "patch",
    "items": {
      "trigger_categories": [
        {
          "id": "10001",
          "position": 20
        },
        {
          "id": "10002",
          "position": 21
        }
      ],
      "triggers": [
        {
          "id": "10011",
          "position": 10,
          "active": false,
          "category_id": "10001"
        },
        {
          "id": "10012",
          "position": 1,
          "active": true,
          "category_id": "10002"
        }
      ]
    }
  }
}'

Go

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	url := "https://example.zendesk.com/api/v2/trigger_categories/jobs"
	method := "POST"
	payload := strings.NewReader(`{
  "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
        }
      ]
    }
  }
}`)
	req, err := http.NewRequest(method, url, payload)

	if err != nil {
		fmt.Println(err)
		return
	}
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "Basic <auth-value>") // Base64 encoded "username:password"

	client := &http.Client {}
	res, err := client.Do(req)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(string(body))
}

Java

import com.squareup.okhttp.*;
OkHttpClient client = new OkHttpClient();
HttpUrl.Builder urlBuilder = HttpUrl.parse("https://example.zendesk.com/api/v2/trigger_categories/jobs")
		.newBuilder();
RequestBody body = RequestBody.create(MediaType.parse("application/json"),
		"""
{
  \"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
        }
      ]
    }
  }
}""");

Request request = new Request.Builder()
		.url(urlBuilder.build())
		.method("POST", body)
		.addHeader("Content-Type", "application/json")
		.addHeader("Authorization", Credentials.basic("your-email", "your-password"))
		.build();
Response response = client.newCall(request).execute();

JavaScript

This example provides an example request for batch operating on existing trigger categories in JavaScript.

fetch("https://{subdomain}.zendesk.com/api/v2/trigger_categories/jobs", {
  "method": "POST",
  "headers": {
    "content-type": "application/json"
  },
  "body": {
    "job": {
      "action": "patch",
      "items": {
        "trigger_categories": [
          {
            "id": "10001",
            "position": 20
          },
          {
            "id": "10002",
            "position": 21
          }
        ],
        "triggers": [
          {
            "id": "10011",
            "position": 10,
            "active": false,
            "category_id": "10001"
          },
          {
            "id": "10012",
            "position": 1,
            "active": true,
            "category_id": "10002"
          }
        ]
      }
    }
  }
})
.then(response => {
  // do stuff with successful response
})
.catch(err => {
  // do stuff with failed response
});

Nodejs

var axios = require('axios');
var data = JSON.stringify({
  "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
        }
      ]
    }
  }
});

var config = {
  method: 'POST',
  url: 'https://example.zendesk.com/api/v2/trigger_categories/jobs',
  headers: {
	'Content-Type': 'application/json',
	'Authorization': 'Basic <auth-value>', // Base64 encoded "username:password"
  },
  data : data,
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests
import json

url = "https://example.zendesk.com/api/v2/trigger_categories/jobs"

payload = json.loads("""{
  "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
        }
      ]
    }
  }
}""")
headers = {
	"Content-Type": "application/json",
}

response = requests.request(
	"POST",
	url,
	auth=('<username>', '<password>'),
	headers=headers,
	json=payload
)

print(response.text)

Ruby

require "net/http"
uri = URI("https://example.zendesk.com/api/v2/trigger_categories/jobs")
request = Net::HTTP::Post.new(uri, "Content-Type": "application/json")
request.body = %q({
  "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
        }
      ]
    }
  }
})
request.basic_auth "username", "password"
response = Net::HTTP.start uri.hostname, uri.port, use_ssl: true do |http|
	http.request(request)
end

Example response(s)

200 OK

// Status 200 OK

{
  "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 Bad Request

// Status 400 Bad Request

{
  "errors": [
    {
      "code": "InvalidTrigger",
      "title": "category_id is not valid",
      "trigger_id": "10001"
    }
  ],
  "status": "failed"
}

Show Trigger Category

• GET /api/v2/trigger_categories/{trigger_category_id}

Returns the trigger category with the specified ID.

Parameters

Name	Type	In	Required	Description
trigger_category_id	string	Path	true	The id of the trigger category to retrieve

Code Samples

cURL

This example provides an example request for an existing trigger category with cURL.

curl -u {email}:{password} -X GET \
  --url https://{subdomain}.zendesk.com/api/v2/trigger_categories/10001

Go

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://example.zendesk.com/api/v2/trigger_categories/10001"
	method := "GET"
	req, err := http.NewRequest(method, url, nil)

	if err != nil {
		fmt.Println(err)
		return
	}
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "Basic <auth-value>") // Base64 encoded "username:password"

	client := &http.Client {}
	res, err := client.Do(req)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(string(body))
}

Java

import com.squareup.okhttp.*;
OkHttpClient client = new OkHttpClient();
HttpUrl.Builder urlBuilder = HttpUrl.parse("https://example.zendesk.com/api/v2/trigger_categories/10001")
		.newBuilder();

Request request = new Request.Builder()
		.url(urlBuilder.build())
		.method("GET", null)
		.addHeader("Content-Type", "application/json")
		.addHeader("Authorization", Credentials.basic("your-email", "your-password"))
		.build();
Response response = client.newCall(request).execute();

JavaScript

This example provides an example request for an existing trigger category in JavaScript.

fetch("https://{subdomain}.zendesk.com/api/v2/trigger_categories/10001", {
  "method": "GET",
  "headers": {}
})
.then(response => {
  // do stuff with successful response
})
.catch(err => {
  // do stuff with failed response
});

Nodejs

var axios = require('axios');

var config = {
  method: 'GET',
  url: 'https://example.zendesk.com/api/v2/trigger_categories/10001',
  headers: {
	'Content-Type': 'application/json',
	'Authorization': 'Basic <auth-value>', // Base64 encoded "username:password"
  },
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests

url = "https://example.zendesk.com/api/v2/trigger_categories/10001"
headers = {
	"Content-Type": "application/json",
}

response = requests.request(
	"GET",
	url,
	auth=('<username>', '<password>'),
	headers=headers
)

print(response.text)

Ruby

require "net/http"
uri = URI("https://example.zendesk.com/api/v2/trigger_categories/10001")
request = Net::HTTP::Get.new(uri, "Content-Type": "application/json")
request.basic_auth "username", "password"
response = Net::HTTP.start uri.hostname, uri.port, use_ssl: true do |http|
	http.request(request)
end

Example response(s)

200 OK

// Status 200 OK

{
  "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 Not Found

// Status 404 Not Found

{
  "errors": [
    {
      "code": "TriggerCategoryNotFound",
      "title": "Category can’t be found. Check the ID and try again."
    }
  ]
}

Update Trigger Category

• PATCH /api/v2/trigger_categories/{trigger_category_id}

Updates the trigger category with the specified ID.

Parameters

Name	Type	In	Required	Description
trigger_category_id	string	Path	true	The id of the trigger category to update

Example body

{
  "trigger_category": {
    "name": "All Notification Triggers Updated",
    "position": 10
  }
}

Code Samples

cURL

This example provides an example request for updating an existing trigger category with cURL.

curl -u {email}:{password} -X PATCH \
  --url https://{subdomain}.zendesk.com/api/v2/trigger_categories/10001 \
  -H 'content-type: application/json' \
  -d '{
  "trigger_category": {
    "name": "Example Category Updated"
  }
}'

Go

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	url := "https://example.zendesk.com/api/v2/trigger_categories/10001"
	method := "PATCH"
	payload := strings.NewReader(`{
  "trigger_category": {
    "name": "All Notification Triggers Updated",
    "position": 10
  }
}`)
	req, err := http.NewRequest(method, url, payload)

	if err != nil {
		fmt.Println(err)
		return
	}
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "Basic <auth-value>") // Base64 encoded "username:password"

	client := &http.Client {}
	res, err := client.Do(req)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(string(body))
}

Java

import com.squareup.okhttp.*;
OkHttpClient client = new OkHttpClient();
HttpUrl.Builder urlBuilder = HttpUrl.parse("https://example.zendesk.com/api/v2/trigger_categories/10001")
		.newBuilder();
RequestBody body = RequestBody.create(MediaType.parse("application/json"),
		"""
{
  \"trigger_category\": {
    \"name\": \"All Notification Triggers Updated\",
    \"position\": 10
  }
}""");

Request request = new Request.Builder()
		.url(urlBuilder.build())
		.method("PATCH", body)
		.addHeader("Content-Type", "application/json")
		.addHeader("Authorization", Credentials.basic("your-email", "your-password"))
		.build();
Response response = client.newCall(request).execute();

JavaScript

This example provides an example request for updating an existing trigger category in JavaScript.

fetch("https://{subdomain}.zendesk.com/api/v2/trigger_categories/10001", {
  "method": "PATCH",
  "headers": {
    "content-type": "application/json"
  },
  "body": {
    "trigger_category": {
      "name": "Example Category Updated"
    }
  }
})
.then(response => {
  // do stuff with successful response
})
.catch(err => {
  // do stuff with failed response
});

Nodejs

var axios = require('axios');
var data = JSON.stringify({
  "trigger_category": {
    "name": "All Notification Triggers Updated",
    "position": 10
  }
});

var config = {
  method: 'PATCH',
  url: 'https://example.zendesk.com/api/v2/trigger_categories/10001',
  headers: {
	'Content-Type': 'application/json',
	'Authorization': 'Basic <auth-value>', // Base64 encoded "username:password"
  },
  data : data,
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests
import json

url = "https://example.zendesk.com/api/v2/trigger_categories/10001"

payload = json.loads("""{
  "trigger_category": {
    "name": "All Notification Triggers Updated",
    "position": 10
  }
}""")
headers = {
	"Content-Type": "application/json",
}

response = requests.request(
	"PATCH",
	url,
	auth=('<username>', '<password>'),
	headers=headers,
	json=payload
)

print(response.text)

Ruby

require "net/http"
uri = URI("https://example.zendesk.com/api/v2/trigger_categories/10001")
request = Net::HTTP::Patch.new(uri, "Content-Type": "application/json")
request.body = %q({
  "trigger_category": {
    "name": "All Notification Triggers Updated",
    "position": 10
  }
})
request.basic_auth "username", "password"
response = Net::HTTP.start uri.hostname, uri.port, use_ssl: true do |http|
	http.request(request)
end

Example response(s)

200 OK

// Status 200 OK

{
  "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 Bad Request

// Status 400 Bad Request

{
  "errors": [
    {
      "code": "InvalidTriggerCategory",
      "title": "Name cannot be blank"
    }
  ]
}

404 Not Found

// Status 404 Not Found

{
  "errors": [
    {
      "code": "TriggerCategoryNotFound",
      "title": "Category can’t be found. Check the ID and try again."
    }
  ]
}

Delete Trigger Category

• DELETE /api/v2/trigger_categories/{trigger_category_id}

Deletes the trigger category with the specified ID.

Parameters

Name	Type	In	Required	Description
trigger_category_id	string	Path	true	The id of the trigger category to delete

Code Samples

cURL

This example provides an example request for deleting an existing trigger category with cURL.

curl -u {email}:{password} -X DELETE \
  --url https://{subdomain}.zendesk.com/api/v2/trigger_categories/10001

Go

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url