Create a product tax rule

POST https://api.tamio.com/v2/taxes/product-tax/create

Creates a new product tax rule with geographical targeting, payment method filtering, and flexible application scope. The tax can apply to all products, selected products, or selected categories. Specify either a percentage rate or a fixed amount (when rate is 0).

Body Parameters

label string*

Human-readable name for the tax rule.

rate number*

Percentage tax rate (0–100). When 0, a fixed amount is required.

amount number

Fixed tax amount in smallest currency unit. Required when rate is 0.

country string*

Country code where the tax applies.

active boolean

Whether the tax rule is active.

applies_to string*

all_products — applies to every product; selected_products — requires products array; selected_categories — requires categories object.

all_productsselected_productsselected_categories

states array of string

State/province restrictions.

postcodes array of string

Postal code restrictions.

payments array of string

Payment methods this tax applies to. Default ["all"].

products array of string

Product UUIDs (required when applies_to is selected_products).

categories object

Category selections (required when applies_to is selected_categories).

Responses

200 Product tax rule created

Product tax rule created

status integer

tax Tax

400 Validation or business-logic error

401 Missing or invalid API key

Retrieve a tax rule

Update a product tax rule

/taxes/product-tax/create

1 const response = await fetch("https://api.tamio.com/v2/taxes/product-tax/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/taxes/product-tax/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,
  "tax": {
    "id": "string",
    "object": "tax",
    "rate": 0,
    "amount": 0,
    "label": "string",
    "active": false,
    "country": "string",
    "type": "product_tax",
    "applies_to": "string",
    "postcodes": [],
    "states": [],
    "payments": [],
    "categories": {},
    "products": []
  }
}

1	const response = await fetch("https://api.tamio.com/v2/taxes/product-tax/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/taxes/product-tax/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