TaxJar provides a comprehensive sales tax API for real-time tax calculations, reporting, and filing.
TaxJar provides a comprehensive sales tax API for real-time tax calculations, reporting, and filing. On Nagent, Taxjar is exposed as a fully-configurable taxes integration that any agent can call — 21 actions, and API key authentication. No code is required to wire Taxjar into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Taxjar to automate the kinds of tasks taxes teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Taxjar into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Taxjar, with input parameters and output schema. Drop these into any step of an agent built in Helix.
TAXJAR_CALCULATE_SALES_TAX_FOR_AN_ORDERTool to calculate sales tax for an order. Use when you need an accurate tax calculation including nexus addresses, line items, shipping, and exemptions.
Input parameters
Order amount (excluding shipping)
Destination ZIP or postal code
Destination city
Origin ZIP or postal code
Shipping cost for the order
Destination state or province
Origin city
Destination street address
Origin state or province
List of line items in the order
Destination country code (ISO 3166-1 alpha-2)
Identifier for the customer, if known
Origin street address
Origin country code (ISO 3166-1 alpha-2)
Type of exemption for the order (e.g., wholesale, government, non_profit, other)
List of seller nexus addresses to consider for tax calculations
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_CREATE_CUSTOMERTool to create a new customer with exemption information. Use when you need to add a customer to your TaxJar account for tax exemption management.
Input parameters
Postal code for the customer's primary address
City for the customer's primary address
Full name of the customer or organization
Two-letter ISO state code for the customer's primary address (e.g., 'CA', 'NY')
Street address for the customer's primary address
Two-letter ISO country code for the customer's primary address (e.g., 'US', 'CA')
Unique identifier for the customer. This ID will be used to reference the customer in future API calls.
List of regions where the customer is exempt from taxes. Each region must specify both country and state.
Type of tax exemption for the customer. Determines how tax calculations will be applied.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_CREATE_ORDER_TRANSACTIONCreates a new order transaction in TaxJar for sales tax reporting and compliance. This action records order transactions that will appear in the TaxJar dashboard for tax filing purposes. The transaction includes customer location, order amounts, shipping costs, and sales tax collected. Important: The 'amount' field must include shipping but exclude sales tax. If line_items are provided, their sum (quantity * unit_price - discount) must equal amount minus shipping.
Input parameters
Total amount of the order including shipping, excluding sales tax. If line_items are provided, must equal sum of (quantity * unit_price - discount) for all items plus shipping.
Latitude of the destination address
Longitude of the destination address
Postal code of the order destination
City of the order destination
Identifier of the user associated with the transaction
Total shipping amount for the order
Two-letter state code for the order destination
Sales tax collected for the order
Street address of the order destination
Line items in the order. If provided, sum of (quantity * unit_price - discount) must equal amount minus shipping.
Two-letter ISO country code of the order destination
Type of exemption if applicable. Must be 'non_exempt' or 'marketplace' if sales_tax is non-zero.
Unique identifier for the transaction
Nexus addresses associated with the transaction
Date/time when transaction occurred (ISO 8601 format)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_CREATE_REFUND_TRANSACTIONTool to create a new refund transaction. Use after confirming refund details.
Input parameters
Total amount refunded (negative value, excluding shipping & tax)
Postal code of refund destination
City of refund destination
E-commerce provider for the transaction
Total shipping refunded (negative for refund)
Two-letter state code for the refund destination
Total sales tax refunded (negative for refund)
Street address of refund destination
Line items detail for the refunded transaction
Two-letter ISO country code of refund destination
Unique identifier for the refund transaction
Date/time when refund occurred (ISO 8601 format)
Identifier of the original order being refunded
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_DELETE_CUSTOMERTool to delete an existing customer. Use when you need to remove a previously created customer by its ID. Example: "Delete customer cust_12345".
Input parameters
Unique identifier of the customer to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_DELETE_ORDER_TRANSACTIONTool to delete an existing order transaction. Use when you need to remove a previously created order transaction by its ID. Example: "Delete transaction abc123".
Input parameters
Unique identifier of the order transaction to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_DELETE_REFUND_TRANSACTIONTool to delete an existing refund transaction. Use when you need to remove a previously created refund transaction by its ID. Example: "Delete refund 243345".
Input parameters
Unique identifier of the refund transaction to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_LIST_CUSTOMERSLists all customer IDs from your TaxJar account. Returns a paginated list of customer IDs (strings). To get full details for a specific customer (including name, address, exemption type, etc.), use the customer ID with the 'Show Customer' action. Use this action to: - Browse all customers in your TaxJar account - Find customer IDs for further operations - Check which customers have been created
Input parameters
Page number for pagination, starting at 1. Use this to navigate through multiple pages of customers.
Maximum number of customer IDs to return per page. Must be between 1 and 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_LIST_NEXUS_REGIONSTool to list existing nexus regions for an account. Use after authenticating your account to discover where you have nexus for sales tax purposes.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_LIST_ORDER_TRANSACTIONSList order transaction IDs within a date range. Returns an array of transaction IDs (strings) for orders created between the specified dates. Use this to discover which orders exist in a date range, then use SHOW_ORDER_TRANSACTION to get details for specific IDs.
Input parameters
Filter by provider source, e.g., 'api' or 'csv'. Defaults to 'api' if not specified.
End date for filtering order transactions (YYYY-MM-DD or YYYY/MM/DD). Required parameter.
Start date for filtering order transactions (YYYY-MM-DD or YYYY/MM/DD). Required parameter.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_LIST_REFUND_TRANSACTIONSLists refund transaction IDs within a specified date range. Returns an array of transaction IDs only. To get detailed information about a specific refund, use the 'Show refund transaction' action with the ID. Useful for finding refunds created through the TaxJar API within a specific time period.
Input parameters
Filter by provider source (e.g., 'api', 'csv')
End date for filtering refund transactions (format: YYYY/MM/DD or YYYY-MM-DD)
Start date for filtering refund transactions (format: YYYY/MM/DD or YYYY-MM-DD)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_LIST_TAX_CATEGORIESTool to list all product tax categories and their codes. Use when you need to discover available tax categories before assigning them to products.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_SHOW_CUSTOMERTool to show an existing customer. Use when you need to retrieve details of a specific customer via TaxJar API.
Input parameters
Unique identifier for the customer
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_SHOW_ORDER_TRANSACTIONTool to show an existing order transaction by ID. Use when you need to retrieve full details of a specific order transaction after creation or listing.
Input parameters
The unique identifier for the order transaction
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_SHOW_REFUND_TRANSACTIONRetrieves detailed information about a specific refund transaction from TaxJar. Use this tool when you need to: - View complete details of a refund transaction including amounts, addresses, and line items - Verify refund transaction data that was previously created - Audit refund information for tax reporting purposes Requires a valid transaction_id that was previously created through TaxJar's API.
Input parameters
The unique ID of the refund transaction to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_SHOW_TAX_RATES_FOR_A_LOCATIONTool to show sales tax rates for a location. Use when you need to retrieve sales tax rates for a specific ZIP code with optional address details (city, state, country, street).
Input parameters
ZIP code to retrieve rates for
City name
State abbreviation
Street address
Two-letter country code (ISO-2), default 'US'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_SUMMARIZE_TAX_RATES_FOR_ALL_REGIONSTool to retrieve minimum and average sales tax rates by region. Use when you need a backup of regional tax summary rates.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_UPDATE_CUSTOMERTool to update an existing customer in TaxJar. Use when you need to modify customer details such as exemption type, name, or address information.
Input parameters
Postal code
City
Customer name
Two-letter ISO state code
Street address
Two-letter ISO country code
Unique identifier of the customer to update
Regions where the customer is exempt from sales tax
Type of exemption for the customer (wholesale, government, marketplace, other, or non_exempt)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_UPDATE_ORDER_TRANSACTIONTool to update an existing order transaction. Use when adjusting order details such as amount, shipping, or line items after creation.
Input parameters
Total amount of the order
Postal code of the order destination
City of the order destination
Transaction provider, e.g., 'api', 'csv'
Total shipping amount for the order
Two-letter state code for the order destination
Sales tax collected for the order
Street address of the order destination
Line items in the order
Two-letter ISO country code of the order destination
Unique identifier for the transaction to update
Date/time when transaction occurred (ISO 8601 format)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_UPDATE_REFUND_TRANSACTIONTool to update an existing refund transaction. Use when adjusting refund details such as amount, shipping, or line items after creation.
Input parameters
Total amount of the refund excluding shipping
Postal code of destination
City of destination
Postal code of origin
Total amount of shipping refunded
Two-letter ISO state code of destination
City of origin
Total amount of sales tax refunded
Street address of destination
Two-letter ISO state code of origin
Line items for the refund
Two-letter ISO country code of destination
Unique identifier of the customer
Street address of origin
Two-letter ISO country code of origin
Type of exemption for the refund
Unique identifier for the refund transaction to update
Date the transaction was recorded (YYYY-MM-DD format)
Unique identifier of the original order transaction
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TAXJAR_VALIDATE_VAT_NUMBERValidates EU VAT identification numbers against the VIES (VAT Information Exchange System) database. Use this tool to: - Verify VAT number format and validity - Check if a VAT number is registered and active in the EU - Retrieve associated company name and address when available - Confirm tax-exempt eligibility before processing transactions The validation queries the European VIES database when available, returning company details for valid registrations. When VIES is unavailable, it falls back to format-based validation using regex patterns.
Input parameters
VAT identification number to validate. Must include the two-letter country code prefix (e.g., 'FR40303265045', 'DE123456789', 'NL123456789B01'). This endpoint validates EU VAT numbers against the VIES (VAT Information Exchange System) database.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 46 agents privately built on Nagent that already use Taxjar.
Build on Nagent
Connect Taxjar to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Taxjar, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Taxjar is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Taxjar is connected, you configure its 21 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Taxjar steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Taxjar event fires, the agent kicks off automatically.
Every Taxjar action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Taxjar ships with 21 pre-built taxes actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Taxjar together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Taxjar-based workflows tailored to your business.