> ## 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: 9004a964-e090-4c62-9ed4-b3ca9fef2f7f
---

# CRM API | Discounts

> Learn how to create and associate a discount 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 discount as part of the pricing details of the quote.

## Create a discount

Discounts are used in conjunction with [fees](/api-reference/latest/crm/objects/fees/guide) and [taxes](/api-reference/latest/crm/objects/taxes/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 fixed, one-time discount",
    "hs_duration": "ONCE",
    "hs_type": "PERCENT",
    "hs_value": "50",
    "hs_sort_order": "2"
  }
}
```

After you create a discount, you can use its ID to associate it with a quote. To retrieve a list of discounts you've created, you can make a `GET` request to `/crm/objects/2026-03/discount`.