Skip to main content
Quaderno logo
  • Category: taxes
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 76
  • Triggers: 0
  • Slug: QUADERNO
  • Version: 20261101_00

Tools

Slug: QUADERNO_ADD_EXPENSE_PAYMENTAdds 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.

Input Parameters

integer
required
The unique identifier for the expense to add payment to
string
required
The payment date in YYYY-MM-DD format
number
Payment amount. If not provided, defaults to the expense total or 0
string
The payment processor name (e.g., stripe, paypal)
string
The payment processor transaction ID
string ("credit_card" | "cash" | "wire_transfer" | "direct_debit" | "check" | "iou" | "paypal" | "other")
required
Payment method used for the expense

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CALCULATE_TAX_RATETool to calculate applicable tax rate for given address and transaction type. Use when you need tax details before invoicing.

Input Parameters

number
Monetary amount for tax calculation
string
Customer’s tax identification number, if available
string
Tax code representing the product or service type
string
required
Destination country code (ISO 3166-1 alpha-2)
string
Origin country code (ISO 3166-1 alpha-2)
string ("good" | "service")
Type of item being sold
string
Postal code of the destination address

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_CONTACTTool to create a new contact (customer or vendor). Use when you need to add a person or company contact in Quaderno.

Input Parameters

string
City or locality of the address.
string ("person" | "company")
required
Type of contact, either ‘person’ or ‘company’.
string
Email address of the contact.
string
State or region of the address.
string
required
2-letter ISO country code.
string
Primary phone number of the contact.
string
Full name of the contact. Useful for companies or alternative display.
string
Last name of the contact. Optional for ‘person’.
string
Department for company contacts.
string
required
First name of the contact (or primary contact name for companies).
string
ZIP or postal code.
string
First line of street address.
string
Primary contact person for company contacts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_COUPONTool 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.

Input Parameters

string
required
Unique coupon code that customers will use at checkout. Must be unique across all coupons.
string
Display name of the coupon shown to customers on invoices. If not provided, the code will be displayed.
string
Three-letter ISO currency code (uppercase) for the amount_off discount. Required if amount_off is provided. Must be a supported currency in your payment processors.
string
Date after which the coupon cannot be redeemed (format: YYYY-MM-DD). If not set, coupon never expires.
number
Fixed amount to discount from the subtotal in the currency specified. Required if percent_off is not provided. Must be positive.
number
Percentage discount to apply to the subtotal (e.g., 25.5 for 25.5% off). Required if amount_off is not provided. Must be between 0 and 100.
integer
Maximum number of times this coupon can be redeemed across all customers before it expires. If not set, coupon has unlimited redemptions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_ESTIMATECreates 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.

Input Parameters

string
Billing city
string
Internal notes for the estimate
string
Estimate number; auto-generated if omitted
string
Billing region/state
string
Customer tax ID
object
required
Contact information - either a reference object like {‘id’: 123} to use an existing contact, or a full contact object with fields like first_name, last_name, email, country, kind (person/company), contact_name
string
Billing country code
string
Estimate subject or summary
string
required
Three-letter ISO currency code (e.g., USD, EUR, GBP)
string
Comma-separated list of tags
string
Purchase order number
string
Estimate issue date (YYYY-MM-DD)
string
Billing postal code
string
Billing street line 1
string
Billing street line 2
object
Custom metadata key/value pairs
string
Payment details info
array
required
List of line items - each item must have ‘description’ (string), ‘quantity’ (number), and ‘unit_price’ (number in currency units, not cents)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_EVIDENCETool 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.

Input Parameters

string
Customer’s IP address for location verification
integer
required
The ID of the invoice/document to attach evidence to
string
Country of customer’s bank (ISO 3166-1 alpha-2 code)
string
Country from billing address (ISO 3166-1 alpha-2 code)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_EXPENSETool 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.

Input Parameters

string
The billing city
array
required
List of line items - each must have description, quantity, and unit_price. Maximum 200 items per request.
string
Extra notes about the expense
string ("outstanding" | "late" | "uncollectible" | "paid" | "refunded" | "archived")
Expense status values.
string
The billing state/province/region
string
required
Supplier/provider contact - either a full contact object with first_name, or a reference object like {‘id’: 123} to use an existing contact
string
The billing country - 2-letter ISO country code
string
An optional summary description of the expense
string
Three-letter ISO currency code (e.g., USD, EUR, GBP)
array
List of tags for categorization
string
Purchase order number
string
Attached file (receipt, invoice, etc.) with base64-encoded data and filename
string
Date when the expense was issued (YYYY-MM-DD format)
string
The billing ZIP or postal code
string
The billing address line 1 (Street address/PO Box)
string
The billing address line 2 (Apartment/Suite/Unit/Building)
string ("credit_card" | "cash" | "wire_transfer" | "direct_debit" | "check" | "iou" | "paypal" | "other")
Payment methods accepted by Quaderno expenses.
object
Set of key-value pairs for storing additional information
string
Detailed information about the payment
string
The payment processor used to pay the expense
string
The ID the payment processor assigned to the payment

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_INVOICECreates 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.

Input Parameters

string
Billing city
array
required
List of line items - each item must have ‘description’ (string), ‘quantity’ (number), and ‘unit_price’ (number in currency units, not cents)
string
Internal notes for the invoice
string
Invoice number; auto-generated if omitted
string
Billing region/state
string
Customer tax ID
object
required
Contact information - either a reference object like {‘id’: 123} to use an existing contact, or a full contact object with fields like first_name, last_name, email, country
string
Billing country code
string
Invoice subject or summary
string
required
Three-letter ISO currency code (e.g., USD, EUR, GBP)
string
Payment due date (YYYY-MM-DD)
object
Evidence object for tax calculation
string
Comma-separated list of tags
string
Purchase order number
object
Attachment object with data, filename, public flag
string
Invoice issue date (YYYY-MM-DD)
string
Billing postal code
string
Billing street line 1
string
Billing street line 2
object
Custom metadata key/value pairs
string
Payment details info
string ("days" | "weeks" | "months" | "years")
Recurring period unit
string
Payment processor name
integer
Processor fee in cents
integer
Recurring frequency number
string
Processor-assigned invoice ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_PRODUCTCreates 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.

Input Parameters

string
required
The product’s SKU (Stock Keeping Unit).
string ("one_off" | "subscription")
Type of product: one-off purchase or subscription.
string
required
The product’s name for customer display.
string
Stock of the physical product.
string
2-letter ISO country code. Required if tax_based_on is ‘country’.
string
Three-letter ISO currency code in uppercase.
string ("excluded" | "included")
Whether taxes are included in the unit_cost.
string ("consulting" | "eservice" | "ebook" | "saas" | "standard" | "reduced")
Tax class that applies to the product.
string
required
The unit price to be charged.
string
The product’s description for customer display.
string ("good" | "service")
The type of the product: ‘good’ or ‘service’.
string ("customer_country" | "country")
How taxes are calculated: based on customer country or a specific country.
string
For Stripe subscriptions: ID of the Stripe price.
string ("daily" | "weekly" | "monthly" | "yearly")
For PayPal subscriptions: billing frequency unit. Defaults to ‘monthly’ if not specified for subscription products.
integer
For subscription products: number of times the charge should recur.
integer
For PayPal subscriptions: number of intervals between subscription billings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_RECEIPTCreates a Quaderno receipt documenting payment for goods or services in a completed transaction. The receipt includes details such as its number, total amounts, online permalink, and PDF URL.

Input Parameters

string
Billing city
array
required
List of line items - each must have ‘description’ (string), ‘quantity’ (number), and ‘unit_price’ (number in currency units, not cents)
string
Internal notes for the receipt
string
Receipt number; auto-generated if omitted
string
Billing region/state
object
required
Contact information - either {‘id’: 123} to reference an existing contact, or a full contact object with at least ‘first_name’
string
Billing country as 2-letter ISO code
string
Brief summary or title for the receipt
string
Three-letter ISO currency code (e.g., USD, EUR). Defaults to account’s base currency if omitted
string
Payment due date (YYYY-MM-DD)
object
Evidence of customer location for tax compliance
array
required
List of payments - each must have ‘payment_method’ (string) and ‘amount’ (number)
array
List of tags for categorizing the receipt
string
Purchase order number
object
Attachment object with ‘data’ (base64), ‘filename’, and optional ‘public’ flag
string
Receipt issue date (YYYY-MM-DD). Defaults to today if omitted
string
Billing postal code
number
Exchange rate for currency conversion
string
Billing street line 1
string
Billing street line 2
object
Custom key-value pairs for additional data
string
Additional payment method information
string
Name of payment processor (e.g., stripe, paypal)
integer
Payment processing fee in cents
string
Transaction ID from the payment processor

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_RECURRINGTool 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.

Input Parameters

array
required
List of line items (max 200 items per request, 1000 total). Each item requires: ‘description’ (string), ‘quantity’ (number), ‘unit_price’ (number in currency units)
string
Extra notes about the recurring
string ("active" | "archived")
Status of the recurring document
array
Array of tax line objects, each detailing a tax applicable to the recurring
object
required
Contact information - either {‘id’: 123} to reference an existing contact, or a full contact object with at least ‘first_name’ field
string
Optional summary description for the document
string
Three-letter ISO currency code in uppercase (e.g., USD, EUR, GBP)
string
Date on which payment is due in YYYY-MM-DD format
string
Date of last document issue in YYYY-MM-DD format
array
List of tags for the recurring document
string ("daily" | "weekly" | "biweekly" | "monthly" | "bimonthly" | "quarterly" | "semiyearly" | "yearly" | "biyearly")
Recurring frequency (deprecated - use recurring_period and recurring_frequency instead)
string
Purchase order number
string
Date of first document issue in YYYY-MM-DD format. Defaults to 1 month from today
object
Key-value pairs for storing additional structured information
string
Detailed information about accepted payment methods
string ("days" | "weeks" | "months" | "years")
Recurring period unit
integer
Number of recurring periods between each document

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_REPORT_REQUESTTool 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.

Input Parameters

object
required
Parameters specifying report details, including the date range (from_date and to_date)
string ("tax_summary" | "invoices_list" | "credits_list")
required
The type of report to generate: ‘tax_summary’ for tax reports, ‘invoices_list’ for invoice reports, or ‘credits_list’ for credit note reports

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_TAX_IDTool 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.

Input Parameters

string
required
Value of the tax ID. For instance, a VAT number.
string
The tax ID’s validity date in YYYY-MM-DD format. Defaults to the beginning of the year.
string
The tax ID’s expiration date in YYYY-MM-DD format, or null if the tax ID has no expiration date.
boolean
Whether the business is registered or not in the EU import scheme for foreign sellers of physical goods.
integer
required
ID of the tax jurisdiction where the tax ID is registered.
boolean
Whether your business has physical presence (office, warehouse, etc) in the given jurisdiction.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_TRANSACTIONTool 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.

Input Parameters

string ("sale" | "refund")
required
Transaction type: ‘sale’ for revenue or ‘refund’ for returns
array
required
Array of line items - each must have description, amount, and tax information
object
Payment information for the transaction.
object
Location evidence for tax compliance.
string
Sales platform name (e.g., ‘shopify’, ‘stripe’, ‘woocommerce’)
string
Sales platform transaction ID for reference and deduplication

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_CREATE_WEBHOOKTool 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.

Input Parameters

string
required
The endpoint URL to receive webhook events. Must be publicly accessible and respond to HEAD requests with 200 OK status for verification.
array
required
Array of event types to subscribe to. Common events include: invoice.created, invoice.updated, invoice.deleted, contact.created, contact.updated, contact.deleted, checkout.succeeded, checkout.abandoned, payment.created, payment.deleted, credit.created, credit.updated, estimate.created, estimate.updated, expense.created, expense.updated, recurring.created, recurring.updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_DELETE_CONTACTTool to permanently delete a contact by ID. Use when you have confirmed the contact ID is correct and no longer need the contact.

Input Parameters

string
required
Unique identifier of the contact to be deleted

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_DELETE_COUPONTool to permanently delete a coupon. Use when you have confirmed the coupon ID is correct and need to remove it permanently (cannot be undone).

Input Parameters

string
required
Unique identifier of the coupon to be deleted

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_DELETE_ESTIMATEPermanently 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).

Input Parameters

string
required
The unique identifier (ID) of the estimate to delete. Can be provided as a string or integer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_DELETE_EXPENSEPermanently 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).

Input Parameters

string
required
The unique identifier (ID) of the expense to delete. Can be provided as a string or integer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_DELETE_PRODUCTTool to permanently delete a product by ID. Use when you have confirmed the product ID is correct and no longer need the product.

Input Parameters

string
required
Unique identifier of the product to be deleted

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_DELETE_RECURRINGTool to permanently delete a recurring by ID. Use when you need to remove a recurring document from Quaderno. This action is irreversible.

Input Parameters

string
required
The unique identifier (ID) of the recurring to be deleted

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_DELETE_TAX_IDPermanently 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.

Input Parameters

string
required
The numeric ID of the registered tax ID to delete (e.g., ‘2313487’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_DELETE_WEBHOOKTool to permanently delete a webhook by ID. Use when you have confirmed the webhook ID is correct and no longer need the webhook.

Input Parameters

integer
required
The unique identifier of the webhook to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_DELIVER_CREDIT_NOTESends 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.

Input Parameters

string
required
Unique identifier of the credit note to deliver. The associated contact must have a valid email address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_DELIVER_ESTIMATEDelivers 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.

Input Parameters

string
required
Unique identifier of the estimate to deliver via email to the customer contact

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_DELIVER_INVOICEDelivers 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.

Input Parameters

string
required
Invoice ID to deliver via email to the customer contact

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_DELIVER_RECEIPTSends 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.

Input Parameters

string
required
Unique identifier of the receipt to deliver. The associated contact must have a valid email address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_GET_AUTHORIZATIONRetrieve Quaderno account authorization details using the configured credentials. Use this to verify API access and obtain identity information, including the publishable key and account API URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_GET_ESTIMATETool to retrieve the details of an existing estimate by ID. Use when you need full estimate information for review or conversion to invoice.

Input Parameters

string
required
ID of the estimate to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_CONTACTSTool to list contacts, paginated and filterable by name, email, or tax ID. Use when you need to retrieve subsets of your contacts.

Input Parameters

string
Filter contacts by full name, email, or tax ID (case-sensitive)
integer
Page number to retrieve (starts at 1). Quaderno paginates at 25 results per page by default.
integer
Number of results per page (default 25, max 200).
string
Filter contacts by external processor ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_COUPONSTool to list all coupons. Use when you need to retrieve available coupons sorted by creation date (newest first).

Input Parameters

integer
Page number to retrieve (starts at 1). Quaderno paginates at 25 results per page by default.
integer
Number of results per page (default 25, max 200).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_CREDITSList a page of credit notes, optionally filtered by search query, date range, state, or processor ID.

Input Parameters

string
Filters credit notes based on the credit number, customer name, or PO number
string
Filters credit notes based on the issue date. A date range must be entered in format ‘YYYY-MM-DD,YYYY-MM-DD’ or ‘YYYY/MM/DD,YYYY/MM/DD’
string ("outstanding" | "late" | "uncollectible" | "paid" | "refunded" | "archived")
Current processing status of a credit note
string
Filters credit notes based on its processor_id

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_ESTIMATESTool 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.

Input Parameters

string
Filter results by contact name
string
Filter by date or date range
string
Filter by estimate state
integer
ID for pagination - returns estimates created before this ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_EVIDENCELists a page of location evidence objects, optionally filtered by state or related document ID. Results are paginated and sorted by creation date, newest first.

Input Parameters

integer
Page number to retrieve (starts at 1). Quaderno paginates at 25 results per page by default.
string
Filter by one or more evidence states, comma-separated. Valid states: ‘confirmed’, ‘unsettled’, ‘conflicting’
integer
Number of results per page (default 25, max 200).
integer
Filter by related document ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_EXPENSESList 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)

Input Parameters

integer
Number of expenses to return per page. Default is 25, maximum is 100.
integer
Numeric expense ID. Returns expenses created before (earlier than) this expense ID, in reverse chronological order. Used for pagination to fetch the next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_INVOICESLists a page of Quaderno invoices with optional filters for invoice number, customer name, date range, payment status, processor ID, or contact ID.

Input Parameters

string
Filters invoices based on invoice number, customer name, or PO number
string
Filters invoices based on issue date. Must be a date range in format ‘2019-01-01,2019-12-31’ or ‘2019/01/01,2019/12/31’
string ("outstanding" | "late" | "uncollectible" | "paid" | "refunded" | "archived")
Invoice state enumeration
integer
Filters invoices based on customer ID
string
Filters invoices based on the processor_id

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_JURISDICTIONSTool to list all tax jurisdictions. Use when you need supported jurisdictions for tax calculations.

Input Parameters

string
Region or state filter. Case-sensitive. Use ‘none’ to return jurisdictions without a region.
string
2-letter ISO 3166-1 country code to filter jurisdictions. Case-sensitive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_PRODUCTSLists a page of Quaderno products, with optional case-sensitive filtering by name or SKU code. Returns product details including pricing, tax settings, and subscription information.

Input Parameters

string
Filter string to search products by name or SKU code (partial matching supported).
integer
Page number to retrieve (starts at 1). Quaderno paginates at 25 results per page by default.
integer
Number of results per page (default 25, max 200).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_RECEIPTSLists a page of Quaderno receipts with optional search query, date range, processor ID, or customer ID filters. A payment-state parameter is also sent if supplied, but its filtering behavior is not established.

Input Parameters

string
Filters receipts by receipt number, customer name, or PO number (case-sensitive)
string
Filters receipts by issue date range. Use format ‘2019-01-01,2019-12-31’ or ‘2019/01/01,2019/12/31’
string ("outstanding" | "late" | "uncollectible" | "paid" | "refunded" | "archived")
Valid receipt states for filtering
integer
Filters receipts by customer ID
string
Filters receipts by external payment processor ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_RECURRINGSList 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.

Input Parameters

integer
Numeric recurring ID. Returns recurring documents created before (earlier than) this recurring ID, in reverse chronological order. Used for pagination to fetch the next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_REGISTERED_TAX_I_DSTool to list all registered tax IDs. Use when retrieving jurisdictions where your business has registered tax IDs. Supports optional cursor-based pagination.

Input Parameters

integer
Maximum number of records to return (default 25, max 100).
integer
Cursor to return only tax IDs created before this timestamp. Use the created_at value from the last record of the previous page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_REPORTING_REQUESTSRetrieves 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)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_SESSIONSList 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.

Input Parameters

integer
Maximum number of sessions to return (1-100)
string
Filter sessions by status
integer
Session ID to paginate from. Returns sessions created before this ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_TAX_CODESTool to list all supported tax codes. Use when you need to retrieve the full set of tax codes for classifying items.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_LIST_WEBHOOKSTool to list all webhooks. Use when you need to retrieve webhook configurations.

Input Parameters

integer
Page number to retrieve (starts at 1). Quaderno paginates at 25 results per page by default.
integer
Number of results per page (default 25, max 200).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_MARK_INVOICE_UNCOLLECTIBLETool to mark an invoice as uncollectible (bad debt). Use when an invoice cannot be collected and should be written off as a loss.

Input Parameters

string
required
The ID of the invoice to mark as uncollectible

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_PINGTool 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.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RECORD_INVOICE_PAYMENTRecords a payment against an existing Quaderno invoice, including the amount and optional payment details. When total payments reach the invoice amount, Quaderno automatically marks the invoice as paid.

Input Parameters

string
required
The ID of the invoice to record a payment for
string
Payment date in YYYY-MM-DD format. Default is current date if not provided
number
required
Paid amount in currency units (not cents)
string
The payment processor used to process the payment
string
The ID the payment processor assigned to the payment
string ("credit_card" | "cash" | "wire_transfer" | "direct_debit" | "check" | "iou" | "paypal" | "other" | "credit")
Payment method options for invoice payment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_REMOVE_INVOICE_PAYMENTTool 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.

Input Parameters

string
required
The unique identifier of the invoice from which to remove the payment. Can be provided as a string or integer.
string
required
The unique identifier of the payment to remove from the invoice. Can be provided as a string or integer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_CONTACTTool to retrieve details of an existing contact by ID. Use after confirming contact ID.

Input Parameters

string
required
ID of the contact to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_CONTACT_BY_PROCESSOR_IDTool 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.

Input Parameters

string
required
Payment gateway name (e.g., stripe, paypal, braintree)
string
required
External customer ID from the payment processor

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_COUPONRetrieve an existing Quaderno Checkout coupon by ID. Use it to review its code, fixed or percentage discount, redemption statistics, and validity details when available.

Input Parameters

string
required
Unique identifier of the coupon to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_CREDITTool to retrieve details of an existing credit note by ID. Use when you need full credit note details for refund processing or reporting.

Input Parameters

integer
required
The unique identifier for the credit note

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_EVIDENCERetrieves 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.

Input Parameters

string
required
The unique identifier of the evidence object to retrieve (numeric string)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_EXPENSETool to retrieve details of an existing expense by ID. Use after confirming expense ID.

Input Parameters

string
required
ID of the expense to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_INVOICERetrieves an existing Quaderno invoice by ID for reporting or reconciliation. The returned invoice is limited to the fields represented by the response model.

Input Parameters

string
required
ID of the invoice to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_JURISDICTIONTool 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”.

Input Parameters

string
required
ID of the desired jurisdiction

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_PRODUCTTool to retrieve details of an existing product by ID. Use after confirming the product ID exists.

Input Parameters

string
required
ID of the desired product

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_RECEIPTTool to retrieve details of an existing receipt by ID. Use when you need full receipt details for reporting or reconciliation.

Input Parameters

string
required
The ID of the desired receipt.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_RECURRINGTool to retrieve details of an existing recurring document by ID. Use when you need information about a recurring invoice or expense subscription.

Input Parameters

string
required
The ID of the desired recurring

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_REPORTING_REQUESTTool 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.

Input Parameters

integer
required
The report request identifier

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_TAX_CODETool to retrieve a specific tax code by ID. Use when you need details about a particular tax code classification.

Input Parameters

string ("consulting" | "ebook" | "eservice" | "exempt" | "reduced" | "saas" | "standard")
required
The ID of the tax code to retrieve: consulting, ebook, eservice, exempt, reduced, saas, or standard

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_RETRIEVE_TAX_IDTool to retrieve details of a specific tax ID by its ID. Use when you need to get information about a registered tax identification number.

Input Parameters

integer
required
ID of the desired tax ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_UPDATE_CONTACTTool to update an existing contact in Quaderno. Use when you need to modify contact details such as name, address, email, or tax information.

Input Parameters

integer
required
ID of the contact to be updated.
string
The contact’s website.
string
City/District/Suburb/Town/Village.
string ("company" | "person")
Type of contact.
string
The contact’s email address.
string
Internal notes about the contact.
string
State/Province/Region.
string
The contact’s tax identification number. Quaderno can validate EU VAT numbers, ABN, and NZBN.
string
2-letter ISO country code.
string
The contact’s phone number.
number
Default discount for this contact.
string
The contact’s preferred language. 2-letter ISO language code.
string
The contact’s last name. Only if the contact is a ‘person’.
string
The external platform where the contact was imported from, if applicable.
string
If the contact is a ‘company’, this is the department.
string
The contact’s first name. Only if the contact is a ‘person’.
string ("taxable" | "exempt" | "reverse")
Tax status for a contact.
string
ZIP or postal code.
string
The ID the payment processor assigned to the contact.
string
Address line 1 (Street address/PO Box).
string
Address line 2 (Apartment/Suite/Unit/Building).
string
If the contact is a ‘company’, this is its contact person.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_UPDATE_COUPONTool 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.

Input Parameters

string
required
Unique identifier of the coupon to update
string
Coupon code. Must be unique across all coupons
string
Name of the coupon displayed to customers on invoices
string
Three-letter ISO currency code (uppercase) required when amount_off is set
string
Date (YYYY-MM-DD format) after which the coupon can no longer be redeemed
number
Fixed amount discount in the specified currency. Cannot be used with percent_off. Requires currency field to be set
number
Percentage discount applied to the purchase subtotal. Cannot be used with amount_off
integer
Maximum number of times this coupon can be redeemed. Set to null for unlimited redemptions

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_UPDATE_CREDIT_NOTETool 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.

Input Parameters

integer
required
ID of the credit note to update
string
Extra notes about the credit note
string
Comma-separated list of tags (e.g., ‘refund,urgent,2026’)
string
Purchase order number
object
Represents a file attachment for the credit note.
string
Billing address line 1
string
Billing address line 2
object
Custom key-value metadata attached to the credit note
string
Details about accepted payment methods

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_UPDATE_ESTIMATEUpdates 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.

Input Parameters

integer
required
ID of the estimate to update
string
Billing city
string
Extra notes about the estimate
string
Billing region/state
string
Customer tax ID
string
Billing country (2-letter ISO code)
string
Estimate subject or summary
string
Three-letter ISO currency code (e.g., USD, EUR, GBP)
string
Comma-separated list of tags (e.g., ‘urgent,Q1-2026,project’)
string
Purchase order number
object
Represents a file attachment for the estimate.
string
Contact identifier
string
Estimate issue date (YYYY-MM-DD)
string
Billing postal code
string
Contact name
string
Billing address line 1
string
Billing address line 2
object
Custom key-value metadata attached to the estimate
string
Details about accepted payment methods
array
List of line items to add, update, or remove

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_UPDATE_EVIDENCETool to update an evidence object. Use when you need to modify location proofs (billing country, IP address, bank country, notes) for tax compliance records.

Input Parameters

integer
required
The unique identifier of the evidence object to update
string
Internal notes about the evidence
string
The customer’s IP address
string
2-letter ISO 3166-1 code for the IP country
integer
Unique identifier for the related invoice
string
2-letter ISO 3166-1 code of the customer’s bank country
string
2-letter ISO 3166-1 code of the billing country
string
Additional evidence used to proof the customer’s location. Required if there’s an additional_evidence_country
string
2-letter ISO 3166-1 code for the additional evidence country

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_UPDATE_EXPENSEUpdates 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.

Input Parameters

integer
required
ID of the expense to update
string
Extra notes about the expense
string
Comma-separated list of tags (e.g., ‘urgent,Q1-2026,corporate’)
string
Purchase order number
string
Billing address line 1
string
Billing address line 2
object
Custom key-value metadata attached to the expense
string
Details about accepted payment methods

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_UPDATE_INVOICEUpdates an existing Quaderno invoice’s supported administrative fields, billing street address, or attachment. Some administrative and billing address fields remain editable after an invoice is finalized.

Input Parameters

integer
required
ID of the invoice to update
string
Extra notes about the invoice
string
Comma-separated list of tags (e.g., ‘urgent,Q1-2026,corporate’)
string
Purchase order number
object
Represents a file attachment for the invoice.
string
Billing address line 1
string
Billing address line 2
object
Custom key-value metadata attached to the invoice
string
Details about accepted payment methods

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_UPDATE_PRODUCTTool to update a product; unspecified fields remain unchanged. Use after fetching the product to apply partial updates.

Input Parameters

integer
required
ID of the product to update
string
Product SKU (Stock Keeping Unit)
string ("one_off" | "subscription")
Transaction type
string
Product name for display
string
Product stock level
string
2-letter ISO country code
string
3-letter ISO currency code, uppercase
string ("excluded" | "included")
Whether unit_cost includes tax or not
string ("consulting" | "eservice" | "ebook" | "saas" | "standard" | "reduced")
Tax class for the product
string
Unit price to be charged
string
Product description for display
string ("good" | "service")
Product type
string ("customer_country" | "country")
Tax calculation basis
string
Stripe subscription price ID
string ("daily" | "weekly" | "monthly" | "yearly")
Subscription billing frequency unit
integer
Subscription recurrence count
integer
Subscription billing frequency count

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_UPDATE_RECURRINGTool 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.

Input Parameters

integer
required
ID of the recurring document to update
array
Line items (max 200 per request, 1000 total per document)
string
Extra notes about the recurring
string ("active" | "archived")
Recurring state options
array
Tax lines applicable to the recurring
object
Contact information for a recurring. Can be either full contact or just ID.
string
Summary description for the document
string
Three-letter ISO currency code in uppercase (e.g., USD, EUR, GBP)
string
Payment due date (format: YYYY-MM-DD, e.g., ‘2020-07-27’)
string
Date of the last document issue (format: YYYY-MM-DD, e.g., ‘2024-01-27’)
array
Tags for categorization (e.g., [‘consulting’, ‘premium’])
string ("daily" | "weekly" | "biweekly" | "monthly" | "bimonthly" | "quarterly" | "semiyearly" | "yearly" | "biyearly")
Recurring frequency options. Deprecated in favor of recurring_period and recurring_frequency.
string
Purchase order number
string
Date of the first document issue (format: YYYY-MM-DD, e.g., ‘2023-01-27’)
object
Key-value pairs for storing additional structured information
string
Detailed information about the accepted payment methods
string ("days" | "weeks" | "months" | "years")
Recurring period options
integer
Number of recurring periods between each document

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_UPDATE_TAX_IDTool 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.

Input Parameters

integer
required
ID of the tax ID to be updated.
string
Value of the tax ID you need fixing.
string
The tax ID’s validity date in YYYY-MM-DD format. Defaults to the beginning of the year.
string
The tax ID’s expiration date in YYYY-MM-DD format, or null if the tax ID has no expiration date.
boolean
Whether the business is registered or not in the EU import scheme for foreign sellers of physical goods.
boolean
Whether your business has physical presence (office, warehouse, etc) in the given jurisdiction.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_UPDATE_WEBHOOKTool to update an existing webhook configuration. Use when you need to modify webhook URL or event subscriptions.

Input Parameters

integer
required
The unique identifier for the webhook to update
string
The webhook endpoint URL that will receive event notifications. Must respond to HEAD requests with 200 OK.
array
An array of event types the webhook should listen for (e.g., invoice.created, contact.created, invoice.updated)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_VALIDATE_TAX_IDTool to validate a tax ID. Use when confirming whether a given country-specific tax ID is valid. Example: validate tax ID ‘DE303954554’ for Germany.

Input Parameters

string
required
The tax identification number to validate.
string
required
Tax ID’s registration country as a 2-letter ISO 3166-1 code.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: QUADERNO_VOID_CREDIT_NOTEAttempts to void an existing credit note by ID. The request does not include the void reason required by Quaderno.

Input Parameters

integer
required
Unique identifier of the credit note to void

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not