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

Responses

200 Ticket category created successfully

Ticket category created successfully

status integer

ticket_category TicketCategory

400 Validation or business-logic error. Possible `error_code` values:

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     // ... request body
9   })
10 });
11 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/agency/ticket-categories/create")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Post.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 request["Content-Type"] = "application/json"
13 request.body = %Q{
14   // ... request body
15 }
16 
17 response = https.request(request)
18 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": "string",
    "auto_reply": "Thank you for contacting us.",
    "subcategories": [
      "Payment Failed",
      "Refund Request"
    ],
    "billing_plans": [],
    "ai_replies": false,
    "ai_prompt": "string",
    "ai_tone": "string",
    "ai_word_count": 0,
    "ai_manual_approvals": false,
    "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	// ... request body
9	})
10	});
11	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/agency/ticket-categories/create")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Post.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12	request["Content-Type"] = "application/json"
13	request.body = %Q{
14	// ... request body
15	}
16
17	response = https.request(request)
18	puts response.read_body