> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to TaxJar

The TaxJar connector lets your AI agent act in each user's TaxJar account. Each user connects their own TaxJar access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 21 tools.

**Authentication:** Bearer Token
**Categories:** Accounting & Finance
**Tools:** 21: 12 read, 6 write, 3 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=TAXJAR)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the TaxJar connection

   In **AgentKit > Connections**, create a TaxJar connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'taxjar'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize TaxJar:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'taxjar_address_validate',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "taxjar"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize TaxJar:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="taxjar_address_validate",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their TaxJar credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'taxjar_address_validate',
  toolInput: {},
  connector: 'taxjar',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="taxjar_address_validate",
    tool_input={},
    connection_name="taxjar",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `taxjar_address_validate`

Validate Address · Read-only

Validate a US customer address and return the matching standardized addresses. Needs a TaxJar Professional or higher plan.
Returns addresses[] with zip (ZIP+4), street, state, country and city.
Use taxjar_address_validate to clean an address before taxjar_tax_calculate. Provide a street with zip, or street with city and state, or the full address in street.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `city` (`string`, optional): City. Example: Gilbert
- `country` (`string`, optional): Two-letter country code; only US addresses can be validated. Example: US
- `state` (`string`, optional): Two-letter state code. Example: AZ
- `street` (`string`, optional): Street address, or the whole address as one freeform line. Example: 3301 South Greenfield Rd
- `zip` (`string`, optional): Postal code (5-digit ZIP or ZIP+4). Example: 85297

Example input: `{}`

### `taxjar_categories_list`

List Product Categories · Read-only

List TaxJar's product categories and their product tax codes.
Returns categories[] with name, product_tax_code and description.
Use taxjar_categories_list to find the product_tax_code for line items in taxjar_tax_calculate or transactions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `taxjar_customer_get`

Get Customer · Read-only

Get one customer created through the API, with exemption details.
Returns customer with customer_id, exemption_type, exempt_regions, name and address.
Use taxjar_customer_get with an ID from taxjar_customers_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`string`, required): Your unique ID for the customer to get. Example: 123

Example input: `{"customer_id":"<customer_id>"}`

### `taxjar_customers_list`

List Customers · Read-only

List the IDs of exempt customers created through the API.
Returns customers[], an array of customer ID strings.
Use taxjar_customers_list to find IDs, then taxjar_customer_get for details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `taxjar_nexus_regions_list`

List Nexus Regions · Read-only

List the regions where the TaxJar account has nexus.
Returns regions[] with country_code, country, region_code and region.
Use taxjar_nexus_regions_list to see where the account collects tax.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `taxjar_order_get`

Get Order · Read-only

Get one order transaction by its transaction ID.
Returns order with transaction_id, transaction_date, addresses, amount, shipping, sales_tax and line_items.
Use taxjar_order_get with an ID from taxjar_orders_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `transaction_id` (`string`, required): Your unique ID for the order transaction (letters, numbers, _ and - only). Example: 123
- `provider` (`string`, optional): Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api

Example input: `{"transaction_id":"<transaction_id>"}`

### `taxjar_orders_list`

List Orders · Read-only

List the IDs of order transactions recorded through the API, for one date or a date range.
Returns orders[], an array of transaction ID strings.
Use taxjar_orders_list to find IDs, then taxjar_order_get for details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_transaction_date` (`string`, optional): Start of the date range. Example: 2026/11/01
- `provider` (`string`, optional): Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
- `to_transaction_date` (`string`, optional): End of the date range. Example: 2026/11/30
- `transaction_date` (`string`, optional): List transactions recorded on this date (yyyy/mm/dd or yyyy-mm-dd). Use it alone, or use the from/to range instead. Example: 2026/11/15

Example input: `{}`

### `taxjar_rates_get`

Get Tax Rates for Location · Read-only

Get the combined sales tax rate and its state, county, city and special district parts for a location.
Returns rate with zip, state, county, city, combined_rate and each component rate (EU and Canada locations return their own fields).
Use taxjar_rates_get for a quick rate lookup. Use taxjar_tax_calculate for an order, since rates do not apply nexus, sourcing or product rules.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `zip` (`string`, required): Postal code of the location (5-digit ZIP or ZIP+4). Example: 90404
- `city` (`string`, optional): City. Example: Santa Monica
- `country` (`string`, optional): Two-letter ISO country code. Example: US
- `state` (`string`, optional): Two-letter state code. Example: CA
- `street` (`string`, optional): Street address, for rooftop accuracy. Example: 312 Hurricane Lane

Example input: `{"zip":"<zip>"}`

### `taxjar_refund_get`

Get Refund · Read-only

Get one refund transaction by its transaction ID.
Returns refund with transaction_id, transaction_reference_id, transaction_date, addresses, amount, shipping, sales_tax and line_items.
Use taxjar_refund_get with an ID from taxjar_refunds_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `transaction_id` (`string`, required): Your unique ID for the refund transaction (letters, numbers, _ and - only). Example: 123-refund
- `provider` (`string`, optional): Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api

Example input: `{"transaction_id":"<transaction_id>"}`

### `taxjar_refunds_list`

List Refunds · Read-only

List the IDs of refund transactions recorded through the API, for one date or a date range.
Returns refunds[], an array of transaction ID strings.
Use taxjar_refunds_list to find IDs, then taxjar_refund_get for details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_transaction_date` (`string`, optional): Start of the date range. Example: 2026/11/01
- `provider` (`string`, optional): Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
- `to_transaction_date` (`string`, optional): End of the date range. Example: 2026/11/30
- `transaction_date` (`string`, optional): List transactions recorded on this date (yyyy/mm/dd or yyyy-mm-dd). Use it alone, or use the from/to range instead. Example: 2026/11/15

Example input: `{}`

### `taxjar_summary_rates_list`

List Summary Rates · Read-only

List minimum and average sales tax rates for every supported region, as a fallback when a live calculation is not possible.
Returns summary_rates[] with country_code, region_code, minimum_rate and average_rate.
Use taxjar_summary_rates_list to cache backup rates. Use taxjar_tax_calculate for real orders.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `taxjar_tax_calculate`

Calculate Sales Tax · Read-only

Calculate the sales tax to collect for an order from its ship-from and ship-to addresses, amounts, line items and exemptions.
Returns tax with amount_to_collect, rate, taxable_amount, has_nexus, freight_taxable, tax_source, jurisdictions and a per-line and per-jurisdiction breakdown. Nothing is saved.
Use taxjar_tax_calculate at checkout. Use taxjar_rates_get for a location's rate only. Use taxjar_order_create to record the completed sale.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `shipping` (`number`, required): Total shipping for the order, in dollars. Example: 1.50
- `to_country` (`string`, required): Two-letter ISO country code where the order shipped to. Example: US
- `to_state` (`string`, required): Two-letter state code where the order shipped to. Example: CA
- `to_zip` (`string`, required): Postal code where the order shipped to (5-digit ZIP or ZIP+4). Example: 90002
- `amount` (`number`, optional): Total order amount excluding shipping, in dollars. Provide amount or line_items. Example: 15
- `customer_id` (`string`, optional): Your customer ID, for applying that customer's exemptions. Example: cust_123
- `exemption_type` (`string`, optional): Exemption type for this order: wholesale, government, marketplace, other or non_exempt. Example: non_exempt. One of: `wholesale`, `government`, `marketplace`, `other`, `non_exempt`.
- `from_city` (`string`, optional): City where the order shipped from. Example: La Jolla
- `from_country` (`string`, optional): Two-letter ISO country code where the order shipped from. Example: US
- `from_state` (`string`, optional): Two-letter state code where the order shipped from. Example: CA
- `from_street` (`string`, optional): Street address where the order shipped from. Example: 9500 Gilman Drive
- `from_zip` (`string`, optional): Postal code where the order shipped from (5-digit ZIP or ZIP+4). Example: 92093
- `line_items` (`array`, optional): Line items. Each can have id, quantity, product_tax_code, unit_price and discount (total, not per unit). Provide line_items or amount. Example: [{"id": "1", "quantity": 1, "product_tax_code": "20010", "unit_price": 15, "discount": 0}]
- `nexus_addresses` (`array`, optional): Nexus addresses to use instead of the account's state settings. Each has id, country, zip, state, city and street; country and state are needed. Example: [{"id": "Main Location", "country": "US", "zip": "92093", "state": "CA", "city": "La Jolla", "street": "9500 Gilman Drive"}]
- `to_city` (`string`, optional): City where the order shipped to. Example: Los Angeles
- `to_street` (`string`, optional): Street address where the order shipped to. Example: 1335 E 103rd St

Example input: `{"shipping":1.5,"to_country":"<to_country>","to_state":"<to_state>","to_zip":"<to_zip>"}`

### `taxjar_customer_create`

Create Customer · Write

Create a customer with an exemption type and optional exempt regions, so orders with its customer_id are calculated as exempt.
Returns the created customer.
Use taxjar_customer_create for a new exempt customer. Use taxjar_customer_update to change one.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `customer_id` (`string`, required): Your unique ID for the customer. Example: 123
- `exemption_type` (`string`, required): Customer exemption type: wholesale, government, other or non_exempt. Example: wholesale. One of: `wholesale`, `government`, `other`, `non_exempt`.
- `name` (`string`, required): Customer name. Example: Dunder Mifflin Paper Company
- `city` (`string`, optional): City of the customer's primary address. Example: Scranton
- `country` (`string`, optional): Country of the customer's primary address. Example: US
- `exempt_regions` (`array`, optional): Regions where the customer is exempt; each has country and state. Leave empty to exempt everywhere. Example: [{"country": "US", "state": "FL"}, {"country": "US", "state": "PA"}]
- `state` (`string`, optional): State of the customer's primary address. Example: PA
- `street` (`string`, optional): Street of the customer's primary address. Example: 1725 Slough Avenue
- `zip` (`string`, optional): Postal code of the customer's primary address. Example: 18504

Example input: `{"customer_id":"<customer_id>","exemption_type":"wholesale","name":"<name>"}`

### `taxjar_customer_update`

Update Customer · Write

Update a customer's name, exemption type, exempt regions or address.
Returns the updated customer.
Use taxjar_customer_update to change exemptions. name and exemption_type are always required.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`string`, required): Your unique ID for the customer to update. Example: 123
- `exemption_type` (`string`, required): Customer exemption type: wholesale, government, other or non_exempt. Example: wholesale. One of: `wholesale`, `government`, `other`, `non_exempt`.
- `name` (`string`, required): Customer name. Example: Dunder Mifflin Paper Company
- `city` (`string`, optional): City of the customer's primary address. Example: Scranton
- `country` (`string`, optional): Country of the customer's primary address. Example: US
- `exempt_regions` (`array`, optional): Regions where the customer is exempt; each has country and state. Leave empty to exempt everywhere. Example: [{"country": "US", "state": "FL"}, {"country": "US", "state": "PA"}]
- `state` (`string`, optional): State of the customer's primary address. Example: PA
- `street` (`string`, optional): Street of the customer's primary address. Example: 1725 Slough Avenue
- `zip` (`string`, optional): Postal code of the customer's primary address. Example: 18504

Example input: `{"customer_id":"<customer_id>","exemption_type":"wholesale","name":"<name>"}`

### `taxjar_order_create`

Create Order · Write

Record a completed sale in TaxJar for sales tax reporting and filing.
Returns the created order transaction.
Use taxjar_order_create after the sale is complete. Use taxjar_refund_create for refunds. Use taxjar_order_update to change it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `amount` (`number`, required): Total amount of the order including shipping and excluding sales tax, in dollars; positive. Example: 16.50
- `sales_tax` (`number`, required): Total sales tax collected for the order, in dollars. Example: 0.95
- `shipping` (`number`, required): Total shipping for the order, in dollars. Example: 1.50
- `to_country` (`string`, required): Two-letter ISO country code where the order shipped to. Example: US
- `to_state` (`string`, required): Two-letter state code where the order shipped to. Example: CA
- `to_zip` (`string`, required): Postal code where the order shipped to (5-digit ZIP or ZIP+4). Example: 90002
- `transaction_date` (`string`, required): Date or date-time the transaction was recorded: 2026-11-15, 2026-11-15T13:05:45 (UTC) or 2026-11-15T13:05:45-05:00. Example: 2026-11-15
- `transaction_id` (`string`, required): Your unique ID for the order transaction (letters, numbers, _ and - only). Example: 123
- `customer_id` (`string`, optional): Your customer ID, for applying that customer's exemptions. Example: cust_123
- `exemption_type` (`string`, optional): Exemption type for this order: wholesale, government, marketplace, other or non_exempt. Example: non_exempt. One of: `wholesale`, `government`, `marketplace`, `other`, `non_exempt`.
- `from_city` (`string`, optional): City where the order shipped from. Example: La Jolla
- `from_country` (`string`, optional): Two-letter ISO country code where the order shipped from. Example: US
- `from_state` (`string`, optional): Two-letter state code where the order shipped from. Example: CA
- `from_street` (`string`, optional): Street address where the order shipped from. Example: 9500 Gilman Drive
- `from_zip` (`string`, optional): Postal code where the order shipped from (5-digit ZIP or ZIP+4). Example: 92093
- `line_items` (`array`, optional): Line items. Each can have id, quantity, product_identifier, description, product_tax_code (from taxjar_categories_list), unit_price, discount (total, not per unit) and sales_tax (total collected for the line). Example: [{"id": "1", "quantity": 1, "product_identifier": "12-34243-9", "description": "Fuzzy Widget", "unit_price": 15, "discount": 0, "sales_tax": 0.95}]
- `provider` (`string`, optional): Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
- `to_city` (`string`, optional): City where the order shipped to. Example: Los Angeles
- `to_street` (`string`, optional): Street address where the order shipped to. Example: 1335 E 103rd St

Example input: `{"amount":16.5,"sales_tax":0.95,"shipping":1.5,"to_country":"<to_country>","to_state":"<to_state>","to_zip":"<to_zip>","transaction_date":"<transaction_date>","transaction_id":"<transaction_id>"}`

### `taxjar_order_update`

Update Order · Write

Update a order transaction recorded through the API; only the fields you pass change.
Returns the updated order transaction.
Use taxjar_order_update to correct a order. Do not use negative amounts to show a refund; use taxjar_refund_create.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `transaction_id` (`string`, required): Your unique ID for the order transaction (letters, numbers, _ and - only). Example: 123
- `amount` (`number`, optional): Total amount of the order including shipping and excluding sales tax, in dollars; positive. Example: 16.50
- `customer_id` (`string`, optional): Your customer ID, for applying that customer's exemptions. Example: cust_123
- `exemption_type` (`string`, optional): Exemption type for this order: wholesale, government, marketplace, other or non_exempt. Example: non_exempt. One of: `wholesale`, `government`, `marketplace`, `other`, `non_exempt`.
- `from_city` (`string`, optional): City where the order shipped from. Example: La Jolla
- `from_country` (`string`, optional): Two-letter ISO country code where the order shipped from. Example: US
- `from_state` (`string`, optional): Two-letter state code where the order shipped from. Example: CA
- `from_street` (`string`, optional): Street address where the order shipped from. Example: 9500 Gilman Drive
- `from_zip` (`string`, optional): Postal code where the order shipped from (5-digit ZIP or ZIP+4). Example: 92093
- `line_items` (`array`, optional): Line items. Each can have id, quantity, product_identifier, description, product_tax_code (from taxjar_categories_list), unit_price, discount (total, not per unit) and sales_tax (total collected for the line). Example: [{"id": "1", "quantity": 1, "product_identifier": "12-34243-9", "description": "Fuzzy Widget", "unit_price": 15, "discount": 0, "sales_tax": 0.95}]
- `sales_tax` (`number`, optional): Total sales tax collected for the order, in dollars. Example: 0.95
- `shipping` (`number`, optional): Total shipping for the order, in dollars. Example: 1.50
- `to_city` (`string`, optional): City where the order shipped to. Example: Los Angeles
- `to_country` (`string`, optional): Two-letter ISO country code where the order shipped to. Example: US
- `to_state` (`string`, optional): Two-letter state code where the order shipped to. Example: CA
- `to_street` (`string`, optional): Street address where the order shipped to. Example: 1335 E 103rd St
- `to_zip` (`string`, optional): Postal code where the order shipped to (5-digit ZIP or ZIP+4). Example: 90002
- `transaction_date` (`string`, optional): Date or date-time the transaction was recorded: 2026-11-15, 2026-11-15T13:05:45 (UTC) or 2026-11-15T13:05:45-05:00. Example: 2026-11-15

Example input: `{"transaction_id":"<transaction_id>"}`

### `taxjar_refund_create`

Create Refund · Write

Record a completed refund of an order in TaxJar for sales tax reporting and filing.
Returns the created refund transaction.
Use taxjar_refund_create after the refund is issued. Use taxjar_order_create for sales. Use taxjar_refund_update to change it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `amount` (`number`, required): Total amount of the refunded order including shipping and excluding sales tax, in dollars; negative (TaxJar signs them automatically). Example: 16.50
- `sales_tax` (`number`, required): Total sales tax collected for the refunded order, in dollars. Example: 0.95
- `shipping` (`number`, required): Total shipping for the refunded order, in dollars. Example: 1.50
- `to_country` (`string`, required): Two-letter ISO country code where the refunded order shipped to. Example: US
- `to_state` (`string`, required): Two-letter state code where the refunded order shipped to. Example: CA
- `to_zip` (`string`, required): Postal code where the refunded order shipped to (5-digit ZIP or ZIP+4). Example: 90002
- `transaction_date` (`string`, required): Date or date-time the transaction was recorded: 2026-11-15, 2026-11-15T13:05:45 (UTC) or 2026-11-15T13:05:45-05:00. Example: 2026-11-15
- `transaction_id` (`string`, required): Your unique ID for the refund transaction (letters, numbers, _ and - only). Example: 123-refund
- `transaction_reference_id` (`string`, required): Transaction ID of the original order being refunded. Example: 123
- `customer_id` (`string`, optional): Your customer ID, for applying that customer's exemptions. Example: cust_123
- `exemption_type` (`string`, optional): Exemption type for this order: wholesale, government, marketplace, other or non_exempt. Example: non_exempt. One of: `wholesale`, `government`, `marketplace`, `other`, `non_exempt`.
- `from_city` (`string`, optional): City where the refunded order shipped from. Example: La Jolla
- `from_country` (`string`, optional): Two-letter ISO country code where the refunded order shipped from. Example: US
- `from_state` (`string`, optional): Two-letter state code where the refunded order shipped from. Example: CA
- `from_street` (`string`, optional): Street address where the refunded order shipped from. Example: 9500 Gilman Drive
- `from_zip` (`string`, optional): Postal code where the refunded order shipped from (5-digit ZIP or ZIP+4). Example: 92093
- `line_items` (`array`, optional): Line items. Each can have id, quantity, product_identifier, description, product_tax_code (from taxjar_categories_list), unit_price, discount (total, not per unit) and sales_tax (total collected for the line). Example: [{"id": "1", "quantity": 1, "product_identifier": "12-34243-9", "description": "Fuzzy Widget", "unit_price": 15, "discount": 0, "sales_tax": 0.95}]
- `provider` (`string`, optional): Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
- `to_city` (`string`, optional): City where the refunded order shipped to. Example: Los Angeles
- `to_street` (`string`, optional): Street address where the refunded order shipped to. Example: 1335 E 103rd St

Example input: `{"amount":16.5,"sales_tax":0.95,"shipping":1.5,"to_country":"<to_country>","to_state":"<to_state>","to_zip":"<to_zip>","transaction_date":"<transaction_date>","transaction_id":"<transaction_id>","transaction_reference_id":"<transaction_reference_id>"}`

### `taxjar_refund_update`

Update Refund · Write

Update a refund transaction recorded through the API; only the fields you pass change.
Returns the updated refund transaction.
Use taxjar_refund_update to correct a refund. Use taxjar_refund_delete to remove it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `transaction_id` (`string`, required): Your unique ID for the refund transaction (letters, numbers, _ and - only). Example: 123-refund
- `transaction_reference_id` (`string`, required): Transaction ID of the original order being refunded. Example: 123
- `amount` (`number`, optional): Total amount of the refunded order including shipping and excluding sales tax, in dollars; negative (TaxJar signs them automatically). Example: 16.50
- `customer_id` (`string`, optional): Your customer ID, for applying that customer's exemptions. Example: cust_123
- `exemption_type` (`string`, optional): Exemption type for this order: wholesale, government, marketplace, other or non_exempt. Example: non_exempt. One of: `wholesale`, `government`, `marketplace`, `other`, `non_exempt`.
- `from_city` (`string`, optional): City where the refunded order shipped from. Example: La Jolla
- `from_country` (`string`, optional): Two-letter ISO country code where the refunded order shipped from. Example: US
- `from_state` (`string`, optional): Two-letter state code where the refunded order shipped from. Example: CA
- `from_street` (`string`, optional): Street address where the refunded order shipped from. Example: 9500 Gilman Drive
- `from_zip` (`string`, optional): Postal code where the refunded order shipped from (5-digit ZIP or ZIP+4). Example: 92093
- `line_items` (`array`, optional): Line items. Each can have id, quantity, product_identifier, description, product_tax_code (from taxjar_categories_list), unit_price, discount (total, not per unit) and sales_tax (total collected for the line). Example: [{"id": "1", "quantity": 1, "product_identifier": "12-34243-9", "description": "Fuzzy Widget", "unit_price": 15, "discount": 0, "sales_tax": 0.95}]
- `sales_tax` (`number`, optional): Total sales tax collected for the refunded order, in dollars. Example: 0.95
- `shipping` (`number`, optional): Total shipping for the refunded order, in dollars. Example: 1.50
- `to_city` (`string`, optional): City where the refunded order shipped to. Example: Los Angeles
- `to_country` (`string`, optional): Two-letter ISO country code where the refunded order shipped to. Example: US
- `to_state` (`string`, optional): Two-letter state code where the refunded order shipped to. Example: CA
- `to_street` (`string`, optional): Street address where the refunded order shipped to. Example: 1335 E 103rd St
- `to_zip` (`string`, optional): Postal code where the refunded order shipped to (5-digit ZIP or ZIP+4). Example: 90002
- `transaction_date` (`string`, optional): Date or date-time the transaction was recorded: 2026-11-15, 2026-11-15T13:05:45 (UTC) or 2026-11-15T13:05:45-05:00. Example: 2026-11-15

Example input: `{"transaction_id":"<transaction_id>","transaction_reference_id":"<transaction_reference_id>"}`

### `taxjar_customer_delete`

Delete Customer · Destructive

Delete a customer created through the API.
Returns the deleted customer.
Use taxjar_customer_delete to remove an exempt customer.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`string`, required): Your unique ID for the customer to delete. Example: 123

Example input: `{"customer_id":"<customer_id>"}`

### `taxjar_order_delete`

Delete Order · Destructive

Delete a order transaction recorded through the API so it is no longer reported.
Returns the deleted order with its transaction_id and empty values.
Use taxjar_order_delete for a order recorded by mistake. Use taxjar_order_update to correct it instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `transaction_id` (`string`, required): Your unique ID for the order transaction (letters, numbers, _ and - only). Example: 123
- `provider` (`string`, optional): Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api

Example input: `{"transaction_id":"<transaction_id>"}`

### `taxjar_refund_delete`

Delete Refund · Destructive

Delete a refund transaction recorded through the API so it is no longer reported.
Returns the deleted refund with its transaction_id and empty values.
Use taxjar_refund_delete for a refund recorded by mistake. Use taxjar_refund_update to correct it instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `transaction_id` (`string`, required): Your unique ID for the refund transaction (letters, numbers, _ and - only). Example: 123-refund
- `provider` (`string`, optional): Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api

Example input: `{"transaction_id":"<transaction_id>"}`

## Related

Other Accounting & Finance connectors ([all 82](/agentkit/connectors/?category=accounting-finance)):

- [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools
- [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
