> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

---
id: 9bcff722-fc2d-4f62-8ac6-6c0741e3f4a6
---

# CRM API | Taxes

> Learn how to create and associate a tax as part of the pricing details of a quote.

export const ScopesList = ({scopes = [], description = "This API requires one of the following scopes:"}) => {
  if (!scopes || scopes.length === 0) {
    return null;
  }
  const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
  return <div>
      <div className="text-sm mb-2">{description}</div>
      <div>
        {sortedScopes.map((scope, index) => <div key={index}>
            <code>
              <span className="text-xs">{scope}</span>
            </code>
          </div>)}
      </div>
    </div>;
};

<Accordion title="Scope requirements">
  <ScopesList
    scopes={[
  'crm.objects.line_items.read',
  'crm.objects.line_items.write'
]}
  />
</Accordion>

When you're [creating a quote in HubSpot](/api-reference/latest/crm/objects/quotes/guide), you can create and associate a tax as part of the pricing details of the quote.

<Warning>
  **Please note:**

  The functionality described in this article pertains to the order-level tax object you can create and apply to [invoices](/api-reference/latest/crm/objects/invoices/guide) and [subscriptions](/api-reference/latest/crm/objects/commerce-subscriptions/guide). 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](/api-reference/latest/crm/objects/line-items/guide#retrieve-tax-rates).
</Warning>

## Create a tax

Taxes are used in conjunction with [discounts](/api-reference/latest/crm/objects/discounts/guide) and [fees](/api-reference/latest/crm/objects/fees/guide) 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.

```json theme={null}
{
  "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/objects/2026-03/tax`.