CRM API | Taxes - HubSpot docs

Postman collection

Scope requirements

When you’re creating a quote in HubSpot, you can create and associate a tax as part of the pricing details of the quote.

Please note:The functionality described in this article pertains to the order-level tax object you can create and apply to invoices and subscriptions. This object is distinct from the tax rate object that applies separately to line items only. Learn more about tax rates in the line items API guide.

Create a tax

Taxes are used in conjunction with discounts and fees when determining the pricing details for a quote. Any discounts you associate with your quote will be applied first, followed by associated fees, and then any associated taxes will apply.

{
  "properties": {
    "hs_label": "A percentage-based tax of 6.5%",
    "hs_type": "PERCENT",
    "hs_value": "6.5"
  }
}

After you create a tax, you can use its ID to associate it with a quote. To retrieve a list of taxes you’ve created, you can make a GET request to /crm/v3/objects/tax.

Postman collection

​Create a tax

Create a tax