Tax Events

A comprehensive list of events that can activate webhooks for tax changes, including creation, updates, and removals.

Events

Event	Description
`tax-created`	Triggers whenever a new tax is created.
`tax-updated`	Triggers whenever a tax is updated.
`tax-removed`	Triggers whenever a tax is deleted.

Webhook Payload Examples

tax-created

{
  "event_id": "whev_o51vdrk4ivy33vpr",
  "event_type": "tax-created",
  "api_version": 2,
  "object": "event",
  "data": {
    "tax": {
      "object": "tax",
      "id": "0c63b80f-d037-48a0-9f96-4d585861c01c",
      "rate": 10,
      "amount": 0,
      "label": "German Tax",
      "active": false,
      "country": "de",
      "type": null,
      "applies_to": "all_products",
      "postcodes": null,
      "states": null,
      "payments": null
    }
  },
  "endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf"
}

tax-updated

{
  "event_id": "whev_wrkndp7ma3822qmq",
  "event_type": "tax-updated",
  "api_version": 2,
  "object": "event",
  "data": {
    "tax": {
      "object": "tax",
      "id": "577082f5-f1e5-4418-8c5a-9846ef7ffa06",
      "rate": 12,
      "amount": 0,
      "label": "German Tax",
      "active": true,
      "country": "de",
      "type": "product_tax",
      "applies_to": "selected_products",
      "postcodes": null,
      "states": null,
      "payments": null
    },
    "changes": [
      "label",
      "active"
    ]
  },
  "endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf"
}

tax-removed

{
  "event_id": "whev_rnwkd895ame22mpp",
  "event_type": "tax-removed",
  "api_version": 2,
  "object": "event",
  "data": {
    "tax": {
      "id": "64305b0e-92f4-46b9-b2da-fa27615c3821"
    }
  },
  "endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf"
}