Batch Taxes

Batch create, update, and delete taxes

POST/taxes/batch

Use it in a workflow

Add a step and choose the WooCommerce connector.
Pick the Batch Taxes action (under Taxes).
Fill in the fields below, then reference the result from later steps as {{batchTaxes.response.data}}.

Request

Request body

Enter the body as JSON in the step's Body field.

createarray<object>

idinteger

Unique identifier for the resource. read-only

countrystring

Country ISO 3166 code. mandatory

statestring

State code.

postcodestring

Postcode/ZIP code.

citystring

City name.

ratestring

Tax rate. mandatory

namestring

Tax rate name. mandatory

priorityinteger

Tax priority.

Default 1

compoundboolean

Whether or not this is a compound rate.

Default false

shippingboolean

Whether or not this tax rate also gets applied to shipping.

Default true

orderinteger

Indicates the order that will appear in queries.

Default 0

classstring

Tax class.

Default "standard"

updatearray<object>

idinteger

Unique identifier for the resource. read-only

countrystring

Country ISO 3166 code. mandatory

statestring

State code.

postcodestring

Postcode/ZIP code.

citystring

City name.

ratestring

Tax rate. mandatory

namestring

Tax rate name. mandatory

priorityinteger

Tax priority.

Default 1

compoundboolean

Whether or not this is a compound rate.

Default false

shippingboolean

Whether or not this tax rate also gets applied to shipping.

Default true

orderinteger

Indicates the order that will appear in queries.

Default 0

classstring

Tax class.

Default "standard"

deletearray<integer>

json

{
  "create": [
    {
      "id": 0,
      "country": "string",
      "state": "string",
      "postcode": "string",
      "city": "string",
      "rate": "string",
      "name": "string",
      "priority": 1,
      "compound": false,
      "shipping": true,
      "order": 0,
      "class": "standard"
    }
  ],
  "update": [
    {
      "id": 0,
      "country": "string",
      "state": "string",
      "postcode": "string",
      "city": "string",
      "rate": "string",
      "name": "string",
      "priority": 1,
      "compound": false,
      "shipping": true,
      "order": 0,
      "class": "standard"
    }
  ],
  "delete": [
    0
  ]
}

Response

Returns 200 with an object. Read it in later steps with {{batchTaxes.response.data.<field>}}.

createarray<object>

idinteger

Unique identifier for the resource. read-only

countrystring

Country ISO 3166 code. mandatory

statestring

State code.

postcodestring

Postcode/ZIP code.

citystring

City name.

ratestring

Tax rate. mandatory

namestring

Tax rate name. mandatory

priorityinteger

Tax priority.

Default 1

compoundboolean

Whether or not this is a compound rate.

Default false

shippingboolean

Whether or not this tax rate also gets applied to shipping.

Default true

orderinteger

Indicates the order that will appear in queries.

Default 0

classstring

Tax class.

Default "standard"

updatearray<object>

idinteger

Unique identifier for the resource. read-only

countrystring

Country ISO 3166 code. mandatory

statestring

State code.

postcodestring

Postcode/ZIP code.

citystring

City name.

ratestring

Tax rate. mandatory

namestring

Tax rate name. mandatory

priorityinteger

Tax priority.

Default 1

compoundboolean

Whether or not this is a compound rate.

Default false

shippingboolean

Whether or not this tax rate also gets applied to shipping.

Default true

orderinteger

Indicates the order that will appear in queries.

Default 0

classstring

Tax class.

Default "standard"

deletearray<object>

idinteger

Unique identifier for the resource. read-only

countrystring

Country ISO 3166 code. mandatory

statestring

State code.

postcodestring

Postcode/ZIP code.

citystring

City name.

ratestring

Tax rate. mandatory

namestring

Tax rate name. mandatory

priorityinteger

Tax priority.

Default 1

compoundboolean

Whether or not this is a compound rate.

Default false

shippingboolean

Whether or not this tax rate also gets applied to shipping.

Default true

orderinteger

Indicates the order that will appear in queries.

Default 0

classstring

Tax class.

Default "standard"

json

{
  "create": [
    {
      "id": 0,
      "country": "string",
      "state": "string",
      "postcode": "string",
      "city": "string",
      "rate": "string",
      "name": "string",
      "priority": 1,
      "compound": false,
      "shipping": true,
      "order": 0,
      "class": "standard"
    }
  ],
  "update": [
    {
      "id": 0,
      "country": "string",
      "state": "string",
      "postcode": "string",
      "city": "string",
      "rate": "string",
      "name": "string",
      "priority": 1,
      "compound": false,
      "shipping": true,
      "order": 0,
      "class": "standard"
    }
  ],
  "delete": [
    {
      "id": 0,
      "country": "string",
      "state": "string",
      "postcode": "string",
      "city": "string",
      "rate": "string",
      "name": "string",
      "priority": 1,
      "compound": false,
      "shipping": true,
      "order": 0,
      "class": "standard"
    }
  ]
}

Need more? See the WooCommerce guide for connection setup and behaviour shared by every action.

Was this page helpful?