Agency API Agency

Create a ticket category

POST https://api.tamio.com/v2/agency/ticket-categories/create

Creates a new ticket category to organize support requests. Categories can be restricted to specific billing plans and have auto-assigned teammates.

Body Parameters

title string*

Category title

language string*

Language code for the category content

automated_reply string

Auto-reply message when tickets are created in this category

teammate_id string

UUID of teammate to auto-assign tickets to

billing_plans array of string

Billing plan UUIDs that have access to this category

subcategories array of string

Subcategory names within this category

Example

{
  "title": "Billing Issues",
  "language": "en",
  "automated_reply": "Thank you for contacting us about billing.",
  "subcategories": [
    "Payment Failed",
    "Refund Request"
  ]
}

Responses

200 Ticket category created successfully

Ticket category created successfully

status integer

ticket_category TicketCategory

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`10239`	Category quota exceeded
`10253`	Agency domain not validated
`1002`	Teammate not found
`10322`	One or more billing plan UUIDs not found

status integer

error string

error_code integer

401 Unauthorized – invalid or missing Bearer token

List all ticket categories

Update a ticket category

/agency/ticket-categories/create

1 const response = await fetch("https://api.tamio.com/v2/agency/ticket-categories/create", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     "title": "Billing Issues",
9     "language": "en",
10     "automated_reply": "Thank you for contacting us about billing.",
11     "subcategories": [
12       "Payment Failed",
13       "Refund Request"
14     ]
15   })
16 });
17 const data = await response.json();

1 require "uri"
2 require "net/http"
3 require "json"
4 
5 url = URI("https://api.tamio.com/v2/agency/ticket-categories/create")
6 
7 https = Net::HTTP.new(url.host, url.port)
8 https.use_ssl = true
9 
10 request = Net::HTTP::Post.new(url)
11 request["Accept"] = "application/json"
12 request["Authorization"] = "Bearer YOUR_API_KEY"
13 request["Content-Type"] = "application/json"
14 request.body = {
15   title: "Billing Issues",
16   language: "en",
17   automated_reply: "Thank you for contacting us about billing.",
18   subcategories: ["Payment Failed", "Refund Request"]
19 }.to_json
20 
21 response = https.request(request)
22 puts response.read_body

Responses

{
  "status": 200,
  "ticket_category": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "object": "ticket_category",
    "title": "Billing Issues",
    "language": "en",
    "teammate_id": "770e8400-e29b-41d4-a716-446655440000",
    "auto_reply": "Thank you for contacting us.",
    "subcategories": [
      "Payment Failed",
      "Refund Request"
    ],
    "billing_plans": [
      "550e8400-e29b-41d4-a716-446655440001",
      "550e8400-e29b-41d4-a716-446655440002"
    ],
    "created_at": 1700000000
  }
}

1	const response = await fetch("https://api.tamio.com/v2/agency/ticket-categories/create", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	"title": "Billing Issues",
9	"language": "en",
10	"automated_reply": "Thank you for contacting us about billing.",
11	"subcategories": [
12	"Payment Failed",
13	"Refund Request"
14	]
15	})
16	});
17	const data = await response.json();

1	require "uri"
2	require "net/http"
3	require "json"
4
5	url = URI("https://api.tamio.com/v2/agency/ticket-categories/create")
6
7	https = Net::HTTP.new(url.host, url.port)
8	https.use_ssl = true
9
10	request = Net::HTTP::Post.new(url)
11	request["Accept"] = "application/json"
12	request["Authorization"] = "Bearer YOUR_API_KEY"
13	request["Content-Type"] = "application/json"
14	request.body = {
15	title: "Billing Issues",
16	language: "en",
17	automated_reply: "Thank you for contacting us about billing.",
18	subcategories: ["Payment Failed", "Refund Request"]
19	}.to_json
20
21	response = https.request(request)
22	puts response.read_body