Quaderno

Integrate Quaderno with your AI workspace

Quaderno is a tax compliance platform that automates tax calculations, invoicing, and reporting for businesses worldwide.

Explore Triggers and Actions

Add Expense Payment

Adds a payment to an existing expense in Quaderno. Use when you need to record a payment received for an expense. Returns the payment record with ID, amount in cents, and payment method details.

ActionTry it

Calculate Tax Rate

Tool to calculate applicable tax rate for given address and transaction type. Use when you need tax details before invoicing.

ActionTry it

Create Contact

Tool to create a new contact (customer or vendor). Use when you need to add a person or company contact in Quaderno.

ActionTry it

Create Coupon

Tool to create a new discount coupon in Quaderno. Use when you need to create either a percentage-based or fixed-amount discount coupon. Either percent_off or amount_off must be provided (but not both). For amount_off coupons, currency is required.

ActionTry it

Create Estimate

Creates a new estimate/quote in Quaderno for a customer with line items. Returns estimate with ID, number, permalink, and total amounts in cents. Use this when you need to create a cost estimate or quote for a project or service.

ActionTry it

Create Evidence

Tool to create a new location evidence for tax compliance. Use when you need to create evidence records with billing country, IP address, or bank country information for verifying customer location.

ActionTry it

Create Expense

Tool to create a business expense in Quaderno. Use when you need to record an expense from a supplier or vendor with line items and optional attachments.

ActionTry it

Create Invoice

Creates a new invoice in Quaderno for a customer with line items. Returns invoice with ID, number, permalink, PDF URL, and total amounts in cents. Use this when you need to bill a customer for products or services.

ActionTry it

Create Product

Creates a new product that can be used as a line item in invoices, credit notes, and expenses. Use this to register products with their SKU, pricing, tax classification, and other details in your Quaderno account.

ActionTry it

Create Receipt

Creates a new receipt in Quaderno documenting payment for goods or services. Returns receipt with ID, number, permalink, PDF URL, and total amounts. Use when you need to create a receipt for a completed transaction.

ActionTry it

Create Recurring

Tool to create a recurring document in Quaderno that automatically generates invoices on a schedule. Use when setting up subscription billing or periodic invoices for a customer.

ActionTry it

Create Report Request

Tool to request a new report generation in Quaderno. Use when you need to generate tax summaries, invoice lists, or credit note lists for a specific date range. Reports are generated asynchronously - this action returns immediately with a 'pending' state. Use the List Reporting Requests action to poll for completion status and retrieve the download URL when the report is ready.

ActionTry it

Create Tax ID

Tool to create a tax ID in a specific jurisdiction. Use when you need to register your business's tax identification number (such as VAT) in a tax jurisdiction.

ActionTry it

Create Transaction

Tool to create a sale or refund transaction in Quaderno. Use when you need to record revenue or refunds - the API automatically generates invoices/credit notes when autosend is enabled. Preferred API for automated invoice generation.

ActionTry it

Create Webhook

Tool to create a new webhook in Quaderno to receive event notifications. Use when you need to subscribe to real-time events like invoice.created or contact.created. Quaderno signs all webhook events with X-Quaderno-Signature header using HMAC-SHA1. Retry logic: 1 attempt/hour for up to 72 hours.

ActionTry it

Delete Contact

Tool to permanently delete a contact by ID. Use when you have confirmed the contact ID is correct and no longer need the contact.

ActionTry it

Delete Coupon

Tool to permanently delete a coupon. Use when you have confirmed the coupon ID is correct and need to remove it permanently (cannot be undone).

ActionTry it

Delete Estimate

Permanently deletes an estimate from Quaderno by its ID. This action removes the estimate record from your Quaderno account. Use this when you need to delete an estimate that was created in error or is no longer needed. The deletion is permanent and cannot be undone. Returns an empty response on success (HTTP 204 No Content).

ActionTry it

Delete Expense

Permanently deletes an expense from Quaderno by its ID. This action removes the expense record from your Quaderno account. Use this when you need to delete an expense that was created in error or is no longer needed. The deletion is permanent and cannot be undone. Returns an empty response on success (HTTP 204 No Content).

ActionTry it

Delete Product

Tool to permanently delete a product by ID. Use when you have confirmed the product ID is correct and no longer need the product.

ActionTry it

Delete Recurring

Tool to permanently delete a recurring by ID. Use when you need to remove a recurring document from Quaderno. This action is irreversible.

ActionTry it

Delete Tax ID

Permanently deletes a registered tax ID from your Quaderno account. Use this when you need to remove a tax jurisdiction registration that is no longer needed.

ActionTry it

Delete Webhook

Tool to permanently delete a webhook by ID. Use when you have confirmed the webhook ID is correct and no longer need the webhook.

ActionTry it

Deliver Credit Note

Sends a credit note to the customer via email. The contact associated with the credit note must have a valid email address. Returns the credit note details including the delivery email and PDF link.

ActionTry it

Deliver Estimate

Delivers an estimate to the customer via email. The estimate's contact must have a valid email address. Use this after creating or finalizing an estimate to send it to the customer.

ActionTry it

Deliver Invoice

Delivers an invoice to the customer via email. The invoice's contact must have a valid email address. Use this after creating or finalizing an invoice to send it to the customer.

ActionTry it

Deliver Receipt

Sends a receipt to the customer via email. The contact associated with the receipt must have a valid email address. Returns the receipt details including the delivery email and PDF link.

ActionTry it

Get Authorization

Tool to retrieve account credentials and verify API access. Use to validate authentication and get account details.

ActionTry it

Get Estimate

Tool to retrieve the details of an existing estimate by ID. Use when you need full estimate information for review or conversion to invoice.

ActionTry it

List Contacts

Tool to list contacts, paginated and filterable by name, email, or tax ID. Use when you need to retrieve subsets of your contacts.

ActionTry it

List Coupons

Tool to list all coupons. Use when you need to retrieve available coupons sorted by creation date (newest first).

ActionTry it

List Credits

Tool to list all credit notes from Quaderno. Use when you need to retrieve credit notes with optional filtering by search query, date range, state, or processor ID.

ActionTry it

List Estimates

Tool to list all estimates in the account, paginated and sorted by creation date (newest first). Use when you need to retrieve estimates, optionally filtered by contact name, state, or date range.

ActionTry it

List Evidence

Tool to list all evidence objects. Use when you need to retrieve location evidences, optionally filtered by state or document ID.

ActionTry it

List Expenses

List all expenses from Quaderno with pagination support. Returns expenses in reverse chronological order (newest first). Each expense includes complete details: contact information, line items, payments, taxes, and custom metadata. Use the 'limit' parameter to control page size (1-100, default 25). Use 'created_before' with an expense ID to paginate through results. Example: List first 50 expenses: ListExpenses(limit=50) Example: Get next page: ListExpenses(limit=50, created_before=168878750)

ActionTry it

List Invoices

Tool to list all invoices from Quaderno with filtering support. Use when you need to retrieve invoices by various criteria such as number, customer name, date range, or payment status.

ActionTry it

List Products

List all products (goods and services) from your Quaderno account. Supports filtering by name or SKU code using the 'q' parameter. Returns product details including pricing, tax settings, and subscription information.

ActionTry it

List Receipts

Tool to list all receipts from Quaderno with optional filtering by search query, date range, payment state, processor ID, or customer ID. Use when you need to retrieve receipts for reporting, reconciliation, or customer queries.

ActionTry it

List Recurrings

List all recurring documents (invoices, expenses, or estimates) from your Quaderno account. Recurring documents automatically generate new documents at specified intervals. Returns documents in reverse chronological order with support for pagination using the 'created_before' parameter.

ActionTry it

List Registered Tax IDs

Tool to list all registered tax IDs. Use when retrieving jurisdictions where your business has registered tax IDs. Supports optional cursor-based pagination.

ActionTry it

List Reporting Requests

Retrieves all reporting requests for the account with their current status and download URLs. Use this tool to check the status of previously created reporting requests and obtain download URLs for completed reports. Reports are generated asynchronously, so use this endpoint to poll for completion status. When a report's state is 'succeeded', the report_url field will contain a temporary download link for the generated CSV file. Common use cases: - Check if a report generation request has completed - Retrieve download URLs for completed reports - Monitor all pending report requests - View historical report generations with their parameters (date ranges, report types)

ActionTry it

List Sessions

List Quaderno Checkout sessions with optional filtering and pagination. Supports cursor-based pagination using 'created_before' and 'limit' parameters, and filtering by session status. Use this to retrieve checkout sessions from your Quaderno account.

ActionTry it

List Tax Codes

Tool to list all supported tax codes. Use when you need to retrieve the full set of tax codes for classifying items.

ActionTry it

List Tax Jurisdictions

Tool to list all tax jurisdictions. Use when you need supported jurisdictions for tax calculations.

ActionTry it

List Webhooks

Tool to list all webhooks. Use when you need to retrieve webhook configurations.

ActionTry it

Mark Invoice Uncollectible

Tool to mark an invoice as uncollectible (bad debt). Use when an invoice cannot be collected and should be written off as a loss.

ActionTry it

Ping API Service

Tool to check if the Quaderno API service is up and verify credentials. Use when testing API connectivity or checking service status before making actual requests.

ActionTry it

Record Invoice Payment

Tool to record a payment on an existing invoice. Use when a customer has paid an invoice and you need to record the payment details in Quaderno.

ActionTry it

Remove Invoice Payment

Tool to remove a payment from an invoice. Use when you need to delete a payment record that was applied to an invoice in error or needs to be adjusted.

ActionTry it

Retrieve Contact

Tool to retrieve details of an existing contact by ID. Use after confirming contact ID.

ActionTry it

Retrieve Contact by Processor ID

Tool to retrieve a contact by external payment processor customer ID and gateway name. Use when you have the processor's customer ID instead of Quaderno's internal contact ID.

ActionTry it

Retrieve Coupon

Retrieve detailed information about a specific coupon by its ID. Use this action when you need to fetch coupon details like discount percentage, redemption limits, or expiration dates. You must first obtain a valid coupon ID from the List Coupons action or from a coupon creation operation. Returns coupon code, discount amount/percentage, redemption statistics, and validity information.

ActionTry it

Retrieve Credit Note

Tool to retrieve details of an existing credit note by ID. Use when you need full credit note details for refund processing or reporting.

ActionTry it

Retrieve Evidence

Retrieves a specific evidence object by its ID. Evidence objects contain location proofs (billing country, IP address, bank country) used for tax compliance. Use this when you need detailed information about a specific evidence record, typically after obtaining the evidence ID from the LIST_EVIDENCE action.

ActionTry it

Retrieve Expense

Tool to retrieve details of an existing expense by ID. Use after confirming expense ID.

ActionTry it

Retrieve Invoice

Tool to retrieve details of an existing invoice by ID. Use when you need full invoice details for reporting or reconciliation.

ActionTry it

Retrieve Product

Tool to retrieve details of an existing product by ID. Use after confirming the product ID exists.

ActionTry it

Retrieve Receipt

Tool to retrieve details of an existing receipt by ID. Use when you need full receipt details for reporting or reconciliation.

ActionTry it

Retrieve Recurring

Tool to retrieve details of an existing recurring document by ID. Use when you need information about a recurring invoice or expense subscription.

ActionTry it

Retrieve Reporting Request

Tool to retrieve the status and download URL of a specific report request by ID. Use when you need to check if a report is ready and get the report_url to download it.

ActionTry it

Retrieve Tax Code

Tool to retrieve a specific tax code by ID. Use when you need details about a particular tax code classification.

ActionTry it

Retrieve Tax ID

Tool to retrieve details of a specific tax ID by its ID. Use when you need to get information about a registered tax identification number.

ActionTry it

Retrieve Tax Jurisdiction

Tool to retrieve a tax jurisdiction by ID. Use when you need the name, country, and region of a specific jurisdiction after confirming its ID. Example: "Retrieve jurisdiction 94".

ActionTry it

Update Contact

Tool to update an existing contact in Quaderno. Use when you need to modify contact details such as name, address, email, or tax information.

ActionTry it

Update Coupon

Tool to update an existing coupon. Use when you need to modify coupon properties like discount amount, name, or redemption limits. Note: Coupons linked to Stripe cannot be edited and will return an error. Only fields provided in the request will be updated; omitted fields remain unchanged.

ActionTry it

Update Credit Note

Tool to update a credit note. Use when you need to modify metadata, tags, notes, billing address, or attach files to an existing credit note. Only limited fields can be updated if it has already been paid or delivered.

ActionTry it

Update Estimate

Updates an existing estimate in Quaderno by modifying allowed fields. Use when you need to change estimate details like notes, purchase order number, tags, payment details, billing address, contact information, or line items. Fields not specified remain unchanged.

ActionTry it

Update Evidence

Tool to update an evidence object. Use when you need to modify location proofs (billing country, IP address, bank country, notes) for tax compliance records.

ActionTry it

Update Expense

Updates an existing expense in Quaderno by modifying allowed fields. This action sends a PUT request to /expenses/{id}.json and returns the complete updated expense. Only specific fields can be modified: purchase order number (po_number), tags (tag_list), payment details (payment_details), notes, billing address (street_line_1, street_line_2), and custom metadata. Use this when you need to add or modify administrative information on an expense. Fields not specified in the request remain unchanged.

ActionTry it

Update Invoice

Updates an existing invoice in Quaderno by modifying allowed fields. This action sends a PUT request to /invoices/{id} and returns the complete updated invoice. Only specific fields can be modified after invoice creation: purchase order number (po_number), tags (tag_list), payment details (payment_details), notes, billing address (street_line_1, street_line_2), custom metadata, and file attachments. Use this when you need to add or modify administrative information on an invoice that hasn't been finalized or paid. Fields not specified in the request remain unchanged.

ActionTry it

Update product

Tool to update a product; unspecified fields remain unchanged. Use after fetching the product to apply partial updates.

ActionTry it

Update Recurring

Tool to update a recurring document in Quaderno. Use when you need to modify subscription details, billing information, line items, or recurring schedule. Only specified fields are updated; unspecified fields remain unchanged.

ActionTry it

Update Tax ID

Tool to update an existing tax ID in Quaderno. Use when you need to modify tax ID details such as validity dates, value, or establishment settings.

ActionTry it

Update Webhook

Tool to update an existing webhook configuration. Use when you need to modify webhook URL or event subscriptions.

ActionTry it

Validate Tax ID

Tool to validate a tax ID. Use when confirming whether a given country-specific tax ID is valid. Example: validate tax ID 'DE303954554' for Germany.

ActionTry it

Void Credit Note

Tool to void a credit note. Use when you need to cancel an existing credit note.

ActionTry it