Skip to main content
Use TaxJar through Corsair: one client, typed API calls. Create a token at taxjar.com under Account, API Access. The plugin sends it as Authorization: Bearer <token>, which is the form TaxJar documents alongside Token token="...". Things to know before you call:
  • Amounts come back as strings. Transaction and rate responses send money and tax rates as decimal strings ("16.5", "0.0625"), while the taxes answer sends numbers. The schemas accept the form each route actually sends, and the exported readNumber helper converts either one.
  • Shipping is required on a transaction. orders.create and refunds.create reject a payload without shipping, even when it is 0. The schema enforces it before the request, so you get a clear error instead of TaxJar’s 422.
  • Calculation is not a transaction. taxes.calculate reports what you should collect. It records nothing, which is why it is a read; use orders.create to record the sale for filing.
  • An update may be refused after filing. TaxJar accepts orders.update and refunds.update until the period is filed; after that the API refuses the change. The plugin does not retry a rejected update.
  • A refund points at its order. Send transaction_reference_id on refunds.create so the refund nets against the original order in reporting.
  • Customer exemption applies forward. A customer created with exemption_type exempts later transactions that cite its customer_id. Omitting exempt_regions covers every region.
  • The list routes return IDs only. orders.list, refunds.list and customers.list answer an array of IDs under their key, not full records; call the get endpoint for the details.
  • Date formats differ by route. The transaction routes document YYYY/MM/DD and also accept YYYY-MM-DD.
  • Deletes cannot be undone. A deleted transaction leaves the tax report, and a deleted customer loses its exemption.
What you get:
  • 21 typed API operations

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

Calculate the tax for a two-state order
Record an order transaction
See the full list on the API page.

What’s next

API reference

Every taxjar.api.* operation with input and output types.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.