---
title: "Create a tax line item on a Quote"
method: POST
path: "/api/quotes/{quoteId}/tax-line-items"
tags: ["Quote Tax Line Item"]
---

# Create a tax line item on a Quote

`POST /api/quotes/{quoteId}/tax-line-items`

## Path parameters

- `quoteId` string, required

## Request body

- QuoteTaxLineItemCreateDto — Represents a tax line item on a quote.
  - `description` string, nullable — Verbose description for this entity.
  - `taxCodeId` string, nullable — Tax code key identifier. Please reference /api/tax-rates endpoint. If FulcrumProduct.PublicApi.Dto.Quote.TaxLineItem.QuoteTaxLineItemCreateDto.AvalaraOptions is provided, FulcrumProduct.PublicApi.Dto.Quote.TaxLineItem.QuoteTaxLineItemCreateDto.TaxCodeId will be ignored.
  - `taxRate` number, double, nullable — Tax rate to use for this entity. If a FulcrumProduct.PublicApi.Dto.Quote.TaxLineItem.QuoteTaxLineItemCreateDto.TaxCodeId is provided, the provided FulcrumProduct.PublicApi.Dto.Quote.TaxLineItem.QuoteTaxLineItemCreateDto.TaxRate will supercede the defined tax rate.
  - `avalaraOptions` DtoCommonAvalaraOptions — Options for use with Avalara (if enabled).
    - `address` CommonAddressDto — Address definition
      - `name` string, nullable — Name of the address (Bob's Shipping, Primary, Reno Warehouse, etc).
      - `address1` string, required — Primary address line.
      - `address2` string, nullable — Second address line.
      - `address3` string, nullable — Third address line.
      - `city` string, required — Address city
      - `stateProvince` string, nullable — Address state/province.
      - `postalCode` string, required — Postal/zip code.
      - `country` string, nullable — Country identifier.
      - `phone` string, tel, nullable — Phone number.
      - `email` string, email, nullable — Email address

## Response `200`

Tax line item added to Quote

- CreatedResponseDto — Response for a created record
  - `id` string, required — The id of the created record

## Other responses

- `400` — Validation issues with input

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/revisions/016c1fd45a3f/schema)