Create a shipping tax rule

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

Creates a new shipping tax rule. The tax can apply to all shipping methods or selected ones. Specify either a percentage rate or a fixed amount (when rate is 0). Rate and amount are mutually exclusive.

Body Parameters

label string*

Human-readable name for the shipping tax rule.

rate number*

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

amount number

Fixed tax amount in smallest currency unit. Mutually exclusive with rate.

active boolean

Whether the shipping tax rule is active.

applies_to string

all_shippings — applies to every shipping method; selected_shippings — requires shippings array.

all_shippingsselected_shippings

shippings array of string

Shipping method UUIDs (required when applies_to is selected_shippings).

Responses

200 Shipping tax rule created

Shipping tax rule created

status integer

tax Tax

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`400`	Invalid request (e.g. selected_shippings scope with no shippings provided)
`1002`	One or more referenced shipping methods not found
`10239`	Fair use limit reached for tax rules

status integer

error string

error_code integer

401 Missing or invalid API key

Update a product tax rule

Update a shipping tax rule

/taxes/shipping-tax/create

1 const response = await fetch("https://api.tamio.com/v2/taxes/shipping-tax/create", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     "label": "Shipping VAT 20%",
9     "rate": 20,
10     "amount": 0,
11     "active": true,
12     "applies_to": "all_shippings",
13     "shippings": [
14       "ddd44567-e89b-12d3-a456-426614174000"
15     ]
16   })
17 });
18 const data = await response.json();

1 require "uri"
2 require "net/http"
3 require "json"
4 
5 url = URI("https://api.tamio.com/v2/taxes/shipping-tax/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   label: "Shipping VAT 20%",
16   rate: 20,
17   amount: 0,
18   active: true,
19   applies_to: "all_shippings",
20   shippings: ["ddd44567-e89b-12d3-a456-426614174000"]
21 }.to_json
22 
23 response = https.request(request)
24 puts response.read_body

Responses

{
  "status": 200,
  "tax": {
    "id": "aaa14567-e89b-12d3-a456-426614174000",
    "object": "tax",
    "rate": 0.2,
    "amount": 0,
    "label": "EU VAT 20%",
    "active": true,
    "country": "GB",
    "type": "product_tax",
    "applies_to": "all_products",
    "postcodes": null,
    "states": null,
    "payments": null,
    "categories": null,
    "products": null
  }
}

1	const response = await fetch("https://api.tamio.com/v2/taxes/shipping-tax/create", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	"label": "Shipping VAT 20%",
9	"rate": 20,
10	"amount": 0,
11	"active": true,
12	"applies_to": "all_shippings",
13	"shippings": [
14	"ddd44567-e89b-12d3-a456-426614174000"
15	]
16	})
17	});
18	const data = await response.json();

1	require "uri"
2	require "net/http"
3	require "json"
4
5	url = URI("https://api.tamio.com/v2/taxes/shipping-tax/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	label: "Shipping VAT 20%",
16	rate: 20,
17	amount: 0,
18	active: true,
19	applies_to: "all_shippings",
20	shippings: ["ddd44567-e89b-12d3-a456-426614174000"]
21	}.to_json
22
23	response = https.request(request)
24	puts response.read_body