01
Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
Taxjar
21 tools available
TaxJar provides a comprehensive sales tax API for real-time tax calculations, reporting, and filing.
Connect Taxjar to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Taxjar's 21 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Common workflows with Taxjar
02
Daily summary
- Pull yesterday's activity
- Summarise with the model of your choice
- Send the digest via email or Slack
03
Cross-tool sync
- Read records from one app
- Transform with a persona
- Write the result back via this integration
Taxjar actions 21
Every Taxjar action below is a callable tool any Definable persona can invoke.
Calculate Sales Tax For An Order
Tool to calculate sales tax for an order. Use when you need an accurate tax calculation including nexus addresses, line items, shipping, and exemptions.
Create Customer
Tool to create a new customer with exemption information. Use when you need to add a customer to your TaxJar account for tax exemption management.
Create Order Transaction
Creates 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.
Create Refund Transaction
Tool to create a new refund transaction. Use after confirming refund details.
Delete Customer
Tool to delete an existing customer. Use when you need to remove a previously created customer by its ID. Example: "Delete customer cust_12345".
Delete Order Transaction
Tool to delete an existing order transaction. Use when you need to remove a previously created order transaction by its ID. Example: "Delete transaction abc123".
Delete Refund Transaction
Tool to delete an existing refund transaction. Use when you need to remove a previously created refund transaction by its ID. Example: "Delete refund 243345".
List Customers
Lists 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
List Nexus Regions
Tool to list existing nexus regions for an account. Use after authenticating your account to discover where you have nexus for sales tax purposes.
List Order Transactions
List 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.
List refund transactions
Lists 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.
List Tax Categories
Tool to list all product tax categories and their codes. Use when you need to discover available tax categories before assigning them to products.
Show Customer
Tool to show an existing customer. Use when you need to retrieve details of a specific customer via TaxJar API.
Show Order Transaction
Tool 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.
Show Refund Transaction
Retrieves 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.
Show Tax Rates for a Location
Tool 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).
Summarize Tax Rates for All Regions
Tool to retrieve minimum and average sales tax rates by region. Use when you need a backup of regional tax summary rates.
Update Customer
Tool to update an existing customer in TaxJar. Use when you need to modify customer details such as exemption type, name, or address information.
Update Order Transaction
Tool to update an existing order transaction. Use when adjusting order details such as amount, shipping, or line items after creation.
Update Refund Transaction
Tool to update an existing refund transaction. Use when adjusting refund details such as amount, shipping, or line items after creation.
Validate VAT Number
Validates 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.
Frequently asked questions
What can I automate with Taxjar on Definable?
Anything Taxjar exposes through its API. Common taxes workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 21 Taxjar tools directly, then chain the result into another integration without you writing code.
How does Taxjar authentication work?
Taxjar uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the Taxjar integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 21 Taxjar tools. You only need a separate Taxjar subscription if Taxjar itself charges per seat or per API call.
Is using Taxjar through Definable secure?
Every call from a persona to Taxjar is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with Taxjar on Definable?
Sign up for Definable, open the integrations page, find Taxjar, and connect via OAuth or API key. You can immediately attach Taxjar to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What Taxjar actions does Definable expose?
Definable exposes all 21 Taxjar actions as callable tools — including `Calculate Sales Tax For An Order`, `Create Customer`, `Create Order Transaction`, plus 18 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with Taxjar?
Wire it up in minutes. No coding required.