Sales Tax

Taxjar

Learn how to use Taxjar with Composio

Overview

SLUG: TAXJAR

Description

TaxJar provides a comprehensive sales tax API for real-time tax calculations, reporting, and filing.

Authentication Details

generic_api_key
stringRequired

Connecting to Taxjar

Create an auth config

Use the dashboard to create an auth config for the Taxjar toolkit. This allows you to connect multiple Taxjar accounts to Composio for agents to use.

1

Select App

Navigate to Taxjar.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Taxjar Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4taxjar_auth_config_id = "ac_YOUR_TAXJAR_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Taxjar for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, taxjar_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Taxjar toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

Tool List

Tool Name: Calculate Sales Tax For An Order

Description

Tool to calculate sales tax for an order. Use when you need an accurate tax calculation including nexus addresses, line items, shipping, and exemptions.

Action Parameters

amount
numberRequired
customer_id
exemption_type
from_city
from_country
stringRequired
from_state
stringRequired
from_street
from_zip
stringRequired
line_items
nexus_addresses
shipping
numberRequired
to_city
to_country
stringRequired
to_state
stringRequired
to_street
to_zip
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Order Transaction

Description

Tool to create a new order transaction. Use after preparing transaction details.

Action Parameters

amount
numberRequired
exemption_type
line_items
nexus_addresses
sales_tax
shipping
numberRequired
to_city
to_country
stringRequired
to_lat
to_lng
to_state
stringRequired
to_street
to_zip
stringRequired
transaction_date
stringRequired
transaction_id
stringRequired
user_id

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Refund Transaction

Description

Tool to create a new refund transaction. Use after confirming refund details.

Action Parameters

amount
numberRequired
line_items
provider
sales_tax
shipping
to_city
to_country
stringRequired
to_state
stringRequired
to_street
to_zip
stringRequired
transaction_date
stringRequired
transaction_id
stringRequired
transaction_reference_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Customer

Description

Tool to delete an existing customer. Use when you need to remove a previously created customer by its ID. Example: "Delete customer cust_12345".

Action Parameters

customer_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Order Transaction

Description

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".

Action Parameters

transaction_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Refund Transaction

Description

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".

Action Parameters

transaction_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Customers

Description

Tool to list existing customers. Use when you need to retrieve customer records after they are created.

Action Parameters

page
Defaults to 1
per_page
Defaults to 30

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Nexus Regions

Description

Tool to list existing nexus regions for an account. Use after authenticating your account to discover where you have nexus for sales tax purposes.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Order Transactions

Description

Tool to list existing order transactions. Use when you need to retrieve created orders for reporting or analysis.

Action Parameters

from_transaction_date
page
Defaults to 1
per_page
Defaults to 20
provider
to_transaction_date
transaction_id

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List refund transactions

Description

Tool to list refund transactions. Use when you need to retrieve refunds created through the TaxJar API.

Action Parameters

page
integerDefaults to 1
per_page
integerDefaults to 20
provider
transaction_date
transaction_id

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Tax Categories

Description

Tool to list all product tax categories and their codes. Use when you need to discover available tax categories before assigning them to products.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Show Customer

Description

Tool to show an existing customer. Use when you need to retrieve details of a specific customer via TaxJar API.

Action Parameters

customer_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Show Order Transaction

Description

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.

Action Parameters

transaction_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Show Refund Transaction

Description

Tool to show a refund transaction. Use when you need to retrieve details of an existing refund transaction via TaxJar API.

Action Parameters

transaction_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Show Tax Rates for a Location

Description

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).

Action Parameters

city
country
state
street
zip
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Summarize Tax Rates for All Regions

Description

Tool to retrieve minimum and average sales tax rates by region. Use when you need a backup of regional tax summary rates.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Order Transaction

Description

Tool to update an existing order transaction. Use when adjusting order details such as amount, shipping, or line items after creation.

Action Parameters

amount
line_items
provider
sales_tax
shipping
to_city
to_country
to_state
to_street
to_zip
transaction_date
transaction_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Validate VAT Number

Description

Tool to validate a VAT number for tax-exempt status. Use when you need to confirm a VAT number's validity and existence before applying tax exemptions.

Action Parameters

vat_number
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired