01
Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
Quaderno
76 tools available
Quaderno is a tax compliance platform that automates tax calculations, invoicing, and reporting for businesses worldwide.
Connect Quaderno to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Quaderno's 76 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 Quaderno
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
Quaderno actions 76
Every Quaderno action below is a callable tool any Definable persona can invoke.
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.
Calculate Tax Rate
Tool to calculate applicable tax rate for given address and transaction type. Use when you need tax details before invoicing.
Create Contact
Tool to create a new contact (customer or vendor). Use when you need to add a person or company contact in Quaderno.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
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).
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).
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.
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.
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.
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.
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.
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.
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.
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.
Get Authorization
Tool to retrieve account credentials and verify API access. Use to validate authentication and get account details.
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.
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.
List Coupons
Tool to list all coupons. Use when you need to retrieve available coupons sorted by creation date (newest first).
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.
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.
List Evidence
Tool to list all evidence objects. Use when you need to retrieve location evidences, optionally filtered by state or document ID.
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)
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.
List Tax Jurisdictions
Tool to list all tax jurisdictions. Use when you need supported jurisdictions for tax calculations.
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.
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.
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.
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.
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)
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.
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.
List Webhooks
Tool to list all webhooks. Use when you need to retrieve webhook configurations.
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.
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.
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.
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.
Retrieve Contact
Tool to retrieve details of an existing contact by ID. Use after confirming contact ID.
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.
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.
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.
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.
Retrieve Expense
Tool to retrieve details of an existing expense by ID. Use after confirming expense ID.
Retrieve Invoice
Tool to retrieve details of an existing invoice by ID. Use when you need full invoice details for reporting or reconciliation.
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".
Retrieve Product
Tool to retrieve details of an existing product by ID. Use after confirming the product ID exists.
Retrieve Receipt
Tool to retrieve details of an existing receipt by ID. Use when you need full receipt details for reporting or reconciliation.
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.
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.
Retrieve Tax Code
Tool to retrieve a specific tax code by ID. Use when you need details about a particular tax code classification.
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.
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.
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.
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.
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.
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.
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.
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.
Update product
Tool to update a product; unspecified fields remain unchanged. Use after fetching the product to apply partial updates.
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.
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.
Update Webhook
Tool to update an existing webhook configuration. Use when you need to modify webhook URL or event subscriptions.
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.
Void Credit Note
Tool to void a credit note. Use when you need to cancel an existing credit note.
Frequently asked questions
What can I automate with Quaderno on Definable?
Anything Quaderno 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 76 Quaderno tools directly, then chain the result into another integration without you writing code.
How does Quaderno authentication work?
Quaderno 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 Quaderno integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 76 Quaderno tools. You only need a separate Quaderno subscription if Quaderno itself charges per seat or per API call.
Is using Quaderno through Definable secure?
Every call from a persona to Quaderno 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 Quaderno on Definable?
Sign up for Definable, open the integrations page, find Quaderno, and connect via OAuth or API key. You can immediately attach Quaderno to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What Quaderno actions does Definable expose?
Definable exposes all 76 Quaderno actions as callable tools — including `Add Expense Payment`, `Calculate Tax Rate`, `Create Contact`, plus 73 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with Quaderno?
Wire it up in minutes. No coding required.