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.
- Tools
- 21
- What they doRead · write · destructive
- 12 · 6 · 312 read6 write3 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the TaxJar connection
In AgentKit > Connections, create a TaxJar connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'taxjar'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'taxjar_address_validate',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "taxjar"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="taxjar_address_validate",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their TaxJar credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_tooltaxjar_address_validateValidate a US customer address and return the matching standardized addresses.Read-onlyValidate Address
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.
Inputs
citystring- City. Example: Gilbert
countrystring- Two-letter country code; only US addresses can be validated. Example: US
statestring- Two-letter state code. Example: AZ
streetstring- Street address, or the whole address as one freeform line. Example: 3301 South Greenfield Rd
zipstring- Postal code (5-digit ZIP or ZIP+4). Example: 85297
taxjar_categories_listList TaxJar's product categories and their product tax codes.Read-onlyList Product Categories
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.
Inputs
This tool takes no inputs.
taxjar_customer_getGet one customer created through the API, with exemption details.Read-onlyGet Customer
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.
Inputs
customer_idstringrequired- Your unique ID for the customer to get. Example: 123
taxjar_customers_listList the IDs of exempt customers created through the API.Read-onlyList Customers
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.
Inputs
This tool takes no inputs.
taxjar_nexus_regions_listList the regions where the TaxJar account has nexus.Read-onlyList Nexus Regions
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.
Inputs
This tool takes no inputs.
taxjar_order_getGet one order transaction by its transaction ID.Read-onlyGet Order
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.
Inputs
transaction_idstringrequired- Your unique ID for the order transaction (letters, numbers, _ and - only). Example: 123
providerstring- Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
taxjar_orders_listList the IDs of order transactions recorded through the API, for one date or a date range.Read-onlyList Orders
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.
Inputs
from_transaction_datestring- Start of the date range. Example: 2026/11/01
providerstring- Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
to_transaction_datestring- End of the date range. Example: 2026/11/30
transaction_datestring- 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
taxjar_rates_getGet the combined sales tax rate and its state, county, city and special district parts for a location.Read-onlyGet Tax Rates for Location
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.
Inputs
zipstringrequired- Postal code of the location (5-digit ZIP or ZIP+4). Example: 90404
citystring- City. Example: Santa Monica
countrystring- Two-letter ISO country code. Example: US
statestring- Two-letter state code. Example: CA
streetstring- Street address, for rooftop accuracy. Example: 312 Hurricane Lane
taxjar_refund_getGet one refund transaction by its transaction ID.Read-onlyGet Refund
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.
Inputs
transaction_idstringrequired- Your unique ID for the refund transaction (letters, numbers, _ and - only). Example: 123-refund
providerstring- Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
taxjar_refunds_listList the IDs of refund transactions recorded through the API, for one date or a date range.Read-onlyList Refunds
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.
Inputs
from_transaction_datestring- Start of the date range. Example: 2026/11/01
providerstring- Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
to_transaction_datestring- End of the date range. Example: 2026/11/30
transaction_datestring- 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
taxjar_summary_rates_listList minimum and average sales tax rates for every supported region, as a fallback when a live calculation is not possible.Read-onlyList Summary Rates
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.
Inputs
This tool takes no inputs.
taxjar_tax_calculateCalculate the sales tax to collect for an order from its ship-from and ship-to addresses, amounts, line items and exemptions.Read-onlyCalculate Sales Tax
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.
Inputs
shippingnumberrequired- Total shipping for the order, in dollars. Example: 1.50
to_countrystringrequired- Two-letter ISO country code where the order shipped to. Example: US
to_statestringrequired- Two-letter state code where the order shipped to. Example: CA
to_zipstringrequired- Postal code where the order shipped to (5-digit ZIP or ZIP+4). Example: 90002
amountnumber- Total order amount excluding shipping, in dollars. Provide amount or line_items. Example: 15
customer_idstring- Your customer ID, for applying that customer's exemptions. Example: cust_123
exemption_typestring- Exemption type for this order: wholesale, government, marketplace, other or non_exempt. Example: non_exemptone of
wholesalegovernmentmarketplaceothernon_exempt from_citystring- City where the order shipped from. Example: La Jolla
from_countrystring- Two-letter ISO country code where the order shipped from. Example: US
from_statestring- Two-letter state code where the order shipped from. Example: CA
from_streetstring- Street address where the order shipped from. Example: 9500 Gilman Drive
from_zipstring- Postal code where the order shipped from (5-digit ZIP or ZIP+4). Example: 92093
line_itemsarray- 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_addressesarray- 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_citystring- City where the order shipped to. Example: Los Angeles
to_streetstring- Street address where the order shipped to. Example: 1335 E 103rd St
taxjar_customer_createCreate a customer with an exemption type and optional exempt regions, so orders with its customer_id are calculated as exempt.WriteCreate Customer
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.
Inputs
customer_idstringrequired- Your unique ID for the customer. Example: 123
exemption_typestringrequired- Customer exemption type: wholesale, government, other or non_exempt. Example: wholesaleone of
wholesalegovernmentothernon_exempt namestringrequired- Customer name. Example: Dunder Mifflin Paper Company
citystring- City of the customer's primary address. Example: Scranton
countrystring- Country of the customer's primary address. Example: US
exempt_regionsarray- 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"}]
statestring- State of the customer's primary address. Example: PA
streetstring- Street of the customer's primary address. Example: 1725 Slough Avenue
zipstring- Postal code of the customer's primary address. Example: 18504
taxjar_customer_updateUpdate a customer's name, exemption type, exempt regions or address.WriteUpdate Customer
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.
- Idempotent
Inputs
customer_idstringrequired- Your unique ID for the customer to update. Example: 123
exemption_typestringrequired- Customer exemption type: wholesale, government, other or non_exempt. Example: wholesaleone of
wholesalegovernmentothernon_exempt namestringrequired- Customer name. Example: Dunder Mifflin Paper Company
citystring- City of the customer's primary address. Example: Scranton
countrystring- Country of the customer's primary address. Example: US
exempt_regionsarray- 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"}]
statestring- State of the customer's primary address. Example: PA
streetstring- Street of the customer's primary address. Example: 1725 Slough Avenue
zipstring- Postal code of the customer's primary address. Example: 18504
taxjar_order_createRecord a completed sale in TaxJar for sales tax reporting and filing.WriteCreate Order
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.
Inputs
amountnumberrequired- Total amount of the order including shipping and excluding sales tax, in dollars; positive. Example: 16.50
sales_taxnumberrequired- Total sales tax collected for the order, in dollars. Example: 0.95
shippingnumberrequired- Total shipping for the order, in dollars. Example: 1.50
to_countrystringrequired- Two-letter ISO country code where the order shipped to. Example: US
to_statestringrequired- Two-letter state code where the order shipped to. Example: CA
to_zipstringrequired- Postal code where the order shipped to (5-digit ZIP or ZIP+4). Example: 90002
transaction_datestringrequired- 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_idstringrequired- Your unique ID for the order transaction (letters, numbers, _ and - only). Example: 123
customer_idstring- Your customer ID, for applying that customer's exemptions. Example: cust_123
exemption_typestring- Exemption type for this order: wholesale, government, marketplace, other or non_exempt. Example: non_exemptone of
wholesalegovernmentmarketplaceothernon_exempt from_citystring- City where the order shipped from. Example: La Jolla
from_countrystring- Two-letter ISO country code where the order shipped from. Example: US
from_statestring- Two-letter state code where the order shipped from. Example: CA
from_streetstring- Street address where the order shipped from. Example: 9500 Gilman Drive
from_zipstring- Postal code where the order shipped from (5-digit ZIP or ZIP+4). Example: 92093
line_itemsarray- 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}]
providerstring- Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
to_citystring- City where the order shipped to. Example: Los Angeles
to_streetstring- Street address where the order shipped to. Example: 1335 E 103rd St
taxjar_order_updateUpdate a order transaction recorded through the API; only the fields you pass change.WriteUpdate Order
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.
- Idempotent
Inputs
transaction_idstringrequired- Your unique ID for the order transaction (letters, numbers, _ and - only). Example: 123
amountnumber- Total amount of the order including shipping and excluding sales tax, in dollars; positive. Example: 16.50
customer_idstring- Your customer ID, for applying that customer's exemptions. Example: cust_123
exemption_typestring- Exemption type for this order: wholesale, government, marketplace, other or non_exempt. Example: non_exemptone of
wholesalegovernmentmarketplaceothernon_exempt from_citystring- City where the order shipped from. Example: La Jolla
from_countrystring- Two-letter ISO country code where the order shipped from. Example: US
from_statestring- Two-letter state code where the order shipped from. Example: CA
from_streetstring- Street address where the order shipped from. Example: 9500 Gilman Drive
from_zipstring- Postal code where the order shipped from (5-digit ZIP or ZIP+4). Example: 92093
line_itemsarray- 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_taxnumber- Total sales tax collected for the order, in dollars. Example: 0.95
shippingnumber- Total shipping for the order, in dollars. Example: 1.50
to_citystring- City where the order shipped to. Example: Los Angeles
to_countrystring- Two-letter ISO country code where the order shipped to. Example: US
to_statestring- Two-letter state code where the order shipped to. Example: CA
to_streetstring- Street address where the order shipped to. Example: 1335 E 103rd St
to_zipstring- Postal code where the order shipped to (5-digit ZIP or ZIP+4). Example: 90002
transaction_datestring- 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
taxjar_refund_createRecord a completed refund of an order in TaxJar for sales tax reporting and filing.WriteCreate Refund
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.
Inputs
amountnumberrequired- Total amount of the refunded order including shipping and excluding sales tax, in dollars; negative (TaxJar signs them automatically). Example: 16.50
sales_taxnumberrequired- Total sales tax collected for the refunded order, in dollars. Example: 0.95
shippingnumberrequired- Total shipping for the refunded order, in dollars. Example: 1.50
to_countrystringrequired- Two-letter ISO country code where the refunded order shipped to. Example: US
to_statestringrequired- Two-letter state code where the refunded order shipped to. Example: CA
to_zipstringrequired- Postal code where the refunded order shipped to (5-digit ZIP or ZIP+4). Example: 90002
transaction_datestringrequired- 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_idstringrequired- Your unique ID for the refund transaction (letters, numbers, _ and - only). Example: 123-refund
transaction_reference_idstringrequired- Transaction ID of the original order being refunded. Example: 123
customer_idstring- Your customer ID, for applying that customer's exemptions. Example: cust_123
exemption_typestring- Exemption type for this order: wholesale, government, marketplace, other or non_exempt. Example: non_exemptone of
wholesalegovernmentmarketplaceothernon_exempt from_citystring- City where the refunded order shipped from. Example: La Jolla
from_countrystring- Two-letter ISO country code where the refunded order shipped from. Example: US
from_statestring- Two-letter state code where the refunded order shipped from. Example: CA
from_streetstring- Street address where the refunded order shipped from. Example: 9500 Gilman Drive
from_zipstring- Postal code where the refunded order shipped from (5-digit ZIP or ZIP+4). Example: 92093
line_itemsarray- 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}]
providerstring- Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
to_citystring- City where the refunded order shipped to. Example: Los Angeles
to_streetstring- Street address where the refunded order shipped to. Example: 1335 E 103rd St
taxjar_refund_updateUpdate a refund transaction recorded through the API; only the fields you pass change.WriteUpdate Refund
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.
- Idempotent
Inputs
transaction_idstringrequired- Your unique ID for the refund transaction (letters, numbers, _ and - only). Example: 123-refund
transaction_reference_idstringrequired- Transaction ID of the original order being refunded. Example: 123
amountnumber- Total amount of the refunded order including shipping and excluding sales tax, in dollars; negative (TaxJar signs them automatically). Example: 16.50
customer_idstring- Your customer ID, for applying that customer's exemptions. Example: cust_123
exemption_typestring- Exemption type for this order: wholesale, government, marketplace, other or non_exempt. Example: non_exemptone of
wholesalegovernmentmarketplaceothernon_exempt from_citystring- City where the refunded order shipped from. Example: La Jolla
from_countrystring- Two-letter ISO country code where the refunded order shipped from. Example: US
from_statestring- Two-letter state code where the refunded order shipped from. Example: CA
from_streetstring- Street address where the refunded order shipped from. Example: 9500 Gilman Drive
from_zipstring- Postal code where the refunded order shipped from (5-digit ZIP or ZIP+4). Example: 92093
line_itemsarray- 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_taxnumber- Total sales tax collected for the refunded order, in dollars. Example: 0.95
shippingnumber- Total shipping for the refunded order, in dollars. Example: 1.50
to_citystring- City where the refunded order shipped to. Example: Los Angeles
to_countrystring- Two-letter ISO country code where the refunded order shipped to. Example: US
to_statestring- Two-letter state code where the refunded order shipped to. Example: CA
to_streetstring- Street address where the refunded order shipped to. Example: 1335 E 103rd St
to_zipstring- Postal code where the refunded order shipped to (5-digit ZIP or ZIP+4). Example: 90002
transaction_datestring- 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
taxjar_customer_deleteDelete a customer created through the API.DestructiveDelete Customer
Delete a customer created through the API. Returns the deleted customer. Use taxjar_customer_delete to remove an exempt customer.
- Idempotent
Inputs
customer_idstringrequired- Your unique ID for the customer to delete. Example: 123
taxjar_order_deleteDelete a order transaction recorded through the API so it is no longer reported.DestructiveDelete Order
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.
- Idempotent
Inputs
transaction_idstringrequired- Your unique ID for the order transaction (letters, numbers, _ and - only). Example: 123
providerstring- Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
taxjar_refund_deleteDelete a refund transaction recorded through the API so it is no longer reported.DestructiveDelete Refund
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.
- Idempotent
Inputs
transaction_idstringrequired- Your unique ID for the refund transaction (letters, numbers, _ and - only). Example: 123-refund
providerstring- Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
No tools match.