Create an exemption
Create an exemption in the resolved organization. customerId is required and must belong to that organization; so must transactionId when you send one. source is not accepted on the body: an exemption created through this API is always recorded with source API. ARCHIVED is not an accepted status here; an archived exemption is absent from every read on this API.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Body
What the exemption applies to.
customerwholesaletransactionreverse_chargepartialPartial-exemption form code, such as CDTFA-230-M. Required when exemptionType is partial. Omit it for every other type.
First day the exemption is in force, as YYYY-MM-DD.
Last day the exemption is in force, as YYYY-MM-DD. Omit it, or send null, for an exemption that does not expire. Must not precede startDate.
ISO 3166-1 alpha-2 country to scope the exemption to. An unrecognized code returns 400.
State or province code to scope the exemption to. Validated against countryCode when you send both; an unrecognized pair returns 400.
Whether the exemption is claimed on the basis of resale.
Federal Employer Identification Number to record.
Sales tax registration number to record.
Lifecycle status to create the exemption with. Defaults to ACTIVE, which is the only status tax calculation applies.
ACTIVEINACTIVEEXPIREDDEACTIVATEDCustomer to hold the exemption against. Must belong to the resolved organization; one that does not returns 400.
Transaction to apply the exemption to. Must belong to the resolved organization; one that does not returns 400. Omit it to exempt the customer's transactions generally.
Response
Kintsugi's unique identifier for the exemption.
Organization the exemption belongs to. Send it as Organization-Id to scope a request to this exemption.
Customer the exemption is held against. null for an exemption recorded against a transaction alone.
Display name of the customer the exemption is held against, resolved when you list or fetch an exemption. null for an exemption recorded against a transaction alone (no customer). Sort a list by it with sort=customerName.
Transaction the exemption applies to. null when it applies to the customer's transactions generally rather than to one of them.
What the exemption applies to.
customerwholesaletransactionreverse_chargepartialPartial-exemption form code, such as CDTFA-230-M. Required when exemptionType is partial. Null for every other exemption type.
Lifecycle status. Only ACTIVE exemptions are applied by tax calculation; the others are retained for reporting.
ACTIVEINACTIVEEXPIREDDEACTIVATEDARCHIVEDISO 3166-1 alpha-2 country the exemption is scoped to. null when it is not scoped to one country.
State or province code the exemption is scoped to, within countryCode. null when it covers the whole country.
First day the exemption is in force, as YYYY-MM-DD.
Last day the exemption is in force, as YYYY-MM-DD. null when it does not expire.
Whether the exemption is claimed on the basis of resale.
Federal Employer Identification Number recorded on the exemption. An empty string when none was recorded.
Sales tax registration number recorded on the exemption. An empty string when none was recorded.
Origin system the exemption was recorded from. null for an exemption recorded before origins were tracked.
NETSUITEQUICKBOOKSINTUIT_ENTERPRISE_SUITESAGE_INTACCTSHOPIFYXEROSTRIPEBIGCOMMERCEMAGENTOMAXIOCHARGEBEEZUORAMICROSOFT_DYNAMICS_365DUALENTRYRECURLYSHOPLINEORBZENSKARHYPERLINEODOOMANUALBULK_UPLOADEMAILCHECKOUTAPIMISSING_CERTIFICATEWhether any certificate document is on file for the exemption. Equivalent to certificates being non-empty, published so a list view does not have to walk the array.
Certificate documents on file, most recent first. An empty list when there are none.
The owning customer's display fields. Absent unless the request passes expand=customer; when expanded it is always an object (never null), though customerName and companyName may each be null.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.