--- title: Zoho Billing API Integration on Truto slug: zohobilling category: Subscription Platform canonical: "https://truto.one/integrations/detail/zohobilling/" --- # Zoho Billing API Integration on Truto **Category:** Subscription Platform **Status:** Generally available ## MCP-ready AI tools Truto exposes 275 tools for Zoho Billing that AI agents can call directly. - **list_all_zoho_billing_organizations** — List Zoho Billing organizations. Returns: organization_id, name, contact_name, email, currency_code, time_zone, and is_org_active for each organization. - **create_a_zoho_billing_organization** — Create a Zoho Billing organization. Returns the created organization including organization_id, name, time_zone, account_created_date, contact_name, and address. Required: name, currency_code, time_zone, portal_name. - **get_single_zoho_billing_organization_by_id** — Get the details of a specific Zoho Billing organization by id. Returns: organization_id, name, contact_name, time_zone, currency_code, email, and address. Required: id. - **update_a_zoho_billing_organization_by_id** — Update the details of a Zoho Billing organization by id, such as its name, time zone, date format, addresses, contact info, tax IDs, and custom fields. Returns the updated organization object including organization_id, name, time_zone, currency_code, email, and address. Required: id. - **list_all_zoho_billing_items** — List items in zohobilling with pagination; active items are returned by default unless filter_by widens the scope. Returns each item's item_id, name, status, description, rate, unit, tax_name, tax_percentage, tax_type, sku, product_type, and custom_fields. Supports name, description, rate, tax_id, search_text, filter_by, and sort_column. - **create_a_zoho_billing_item** — Create a new item in zohobilling. Returns the created item including item_id, name, status, description, rate, unit, tax_name, tax_percentage, tax_type, sku, product_type, item_tax_preferences, and custom_fields. Requires name and rate; item names must be unique. - **get_single_zoho_billing_item_by_id** — Get details of an existing item in zohobilling by its id. Returns the item's item_id, name, status, description, rate, unit, tax details (tax_id, tax_name, tax_percentage, tax_type), sku, product_type, custom_fields, and item_tax_preferences. Required: id. - **update_a_zoho_billing_item_by_id** — Update the details of an existing item in zohobilling by its id. Returns the updated item, including item_id, name, status, description, rate, unit, and tax details. Required: id. - **delete_a_zoho_billing_item_by_id** — Delete an existing item in zohobilling by its id. Returns code and message on success. Items that are part of a transaction cannot be deleted. Required: id. - **list_all_zoho_billing_itemdetails** — Bulk fetch item details for the specified item IDs in Zoho Billing. Returns: code, message, and items, where each item includes item_id, name, status, description, rate, unit, tax_id, tax_name, tax_percentage, tax_type, sku, product_type, and custom_fields. Required: item_ids (comma-separated list of item ids). - **create_a_zoho_billing_item_active** — Mark an inactive item as active in zohobilling. Returns: code, message. Required: item_id. - **create_a_zoho_billing_item_inactive** — Mark an active item as inactive in Zoho Billing. Returns: code, message. Required: item_id. - **list_all_zoho_billing_products** — List all products created in Zoho Billing. Returns each product's product_id, name, description, status, and created_time. - **create_a_zoho_billing_product** — Create a new product in Zoho Billing. Returns the created product including product_id, name, description, email_ids, redirect_url, status, created_time, and updated_time. Required: name. - **get_single_zoho_billing_product_by_id** — Get details of an existing Zoho Billing product by id. Returns the product record including product_id, name, description, status, and created_time. Required: id (product_id). - **update_a_zoho_billing_product_by_id** — Update details of an existing product in Zoho Billing. Returns the updated product including product_id, name, description, email_ids, redirect_url, status, created_time, and updated_time. Required: id (product_id). - **delete_a_zoho_billing_product_by_id** — Delete an existing product in Zoho Billing by id. Returns a JSON confirmation body with code and message on success. Required: id. - **create_a_zoho_billing_product_markasactive** — Mark a product as active in Zoho Billing. Returns: code, message. Required: product_id. - **create_a_zoho_billing_product_markasinactive** — Mark a Zoho Billing product as inactive. Returns: code, message. Required: product_id. - **zoho_billing_product_emailtemplates_bulk_update** — Update the email templates associated with a product in zohobilling. Returns: code, message, and the updated product with product_id, name, status, and created_time. Required: product_id. - **list_all_zoho_billing_plans** — List all Zoho Billing plans. Returns plans with plan_code, name, status, recurring_price, interval_unit, and url. Filter by status with filter_by or by product with product_id. - **create_a_zoho_billing_plan** — Create a new plan in Zoho Billing. Returns the created plan including plan_code, name, status, recurring_price, interval_unit, url, and created_time. Required: plan_code, name, recurring_price, interval, product_id. - **get_single_zoho_billing_plan_by_id** — Retrieve details of an existing Zoho Billing plan by its id (the plan_code). Returns the plan including plan_code, name, status, recurring_price, interval_unit, url, created_time, and updated_time. Required: id. - **update_a_zoho_billing_plan_by_id** — Update details of an existing Zoho Billing plan by its plan_code. Returns the updated plan including plan_code, name, recurring_price, interval_unit, and status. Required: id (the plan_code). - **delete_a_zoho_billing_plan_by_id** — Delete a Zoho Billing plan by its plan_code. A plan can only be deleted if it has no transactions associated with it. Returns confirmation with code and message. Required: id (the plan_code). - **create_a_zoho_billing_plan_markasactive** — Mark an existing plan as active in Zoho Billing, changing the plan's status to active. Returns: code, message. Required: plan_code. - **create_a_zoho_billing_plan_markasinactive** — Mark a plan as inactive in Zoho Billing, changing the status of the plan identified by its plan code. Returns a status confirmation with code and message. Required: plan_code. - **create_a_zoho_billing_plan_markasfree** — Mark an existing Zoho Billing plan as free, changing it to a free plan. Returns: code, message. Required: plan_code. - **create_a_zoho_billing_plan_markasnonfree** — Mark a zohobilling plan as non-free, changing it from a free plan to a paid one. Returns: code, message. Required: plan_code. - **delete_a_zoho_billing_plan_comment_by_id** — Delete an existing comment on a Zoho Billing plan. Returns code and message confirming the deletion. Required: plan_id and id (the comment id). - **create_a_zoho_billing_plan_comment** — Add a comment to a plan in Zoho Billing. Returns code, message, and the created comment object including comment_id, description, commented_by, and date. Required: plan_id, organization_id, and description. - **list_all_zoho_billing_plan_comments** — List comments for a plan in Zoho Billing. Returns code, message, and comments — each with comment_id, description, commented_by, date, and comment_type. Required: plan_id and organization_id. - **list_all_zoho_billing_addons** — List all addons in Zoho Billing. Returns code, message, and the addons array of addon records with addon_code, name, pricing_scheme, price_brackets, status, product_id, and created_time. - **create_a_zoho_billing_addon** — Create a new addon in Zoho Billing. Returns code, message, and the created addon object with addon_code, name, pricing_scheme, price_brackets, type, plans, product_id, and status. Required: addon_code, name, unit_name, price_brackets, plans, and product_id. - **get_single_zoho_billing_addon_by_id** — Get a single addon in Zoho Billing by id. Returns code, message, and the addon object with addon_code, name, unit_name, pricing_scheme, price_brackets, plans, status, product_id, and created_time. Required: id (the addon's unique code). - **update_a_zoho_billing_addon_by_id** — Update details of an existing addon in Zoho Billing by id. Returns code, message, and the updated addon object with addon_code, name, pricing_scheme, price_brackets, status, product_id, and updated_time. Required: id, addon_code, name, unit_name, and price_brackets. - **delete_a_zoho_billing_addon_by_id** — Delete an existing addon in Zoho Billing by id. Returns a confirmation payload with code and message confirming the deletion. Required: id (the addon's unique code). - **create_a_zoho_billing_addon_markasactive** — Mark a zohobilling addon as active, changing the addon's status to active. Returns: code, message. Required: addon_code. - **create_a_zoho_billing_addon_markasinactive** — Mark a Zoho Billing addon as inactive, changing its status so it is no longer offered. Returns: code, message. Required: addon_code. - **delete_a_zoho_billing_addon_comment_by_id** — Delete a comment from an addon in zohobilling. Returns: code, message. Required: addon_id, id (the comment id). - **create_a_zoho_billing_addon_comment** — Add a comment to an addon in zohobilling. Returns: code, message, comment. Required: addon_id. - **list_all_zoho_billing_addon_comments** — List all comments on an addon in zohobilling. Returns: code, message, comments. Required: addon_id. - **list_all_zoho_billing_coupons** — List all coupons in Zoho Billing. Returns: code, message, and coupons (array of records with coupon_code, name, status, discount_value, and expiry_at). Filter with filter_by and product_id. - **create_a_zoho_billing_coupon** — Create a new coupon in Zoho Billing. Returns: code, message, and the coupon object with coupon_code, name, status, discount_value, and expiry_at. Requires coupon_code, name, type, discount_by, and product_id; duration is also required for duration type coupons. - **get_single_zoho_billing_coupon_by_id** — Get details of an existing coupon in Zoho Billing by id (coupon_code). Returns the coupon object (coupon_code, name, status, discount_value, expiry_at), plus code and message. Required: id (coupon_code). - **update_a_zoho_billing_coupon_by_id** — Update details of an existing coupon in Zoho Billing by id (coupon_code). Returns the updated coupon object (coupon_code, name, status, discount_value, expiry_at), plus code and message. Requires name and id (coupon_code). - **delete_a_zoho_billing_coupon_by_id** — Delete an existing coupon in Zoho Billing by id (coupon_code). Returns a status code and confirmation message. Required: id (coupon_code). - **create_a_zoho_billing_coupon_markasactive** — Mark a coupon as active in Zoho Billing, changing its status to active. Returns: code, message. Required: coupon_code. - **create_a_zoho_billing_coupon_markasinactive** — Mark a Zoho Billing coupon as inactive, changing its status so it can no longer be applied. Returns a status confirmation with code and message (e.g. "The coupon has been marked as inactive."). Required: coupon_code. - **create_a_zoho_billing_markasactive** — Mark a coupon set as active in Zoho Billing, changing its status to active. Returns: code, message. Required: coupon_set_id. - **create_a_zoho_billing_markasinactive** — Mark a Zoho Billing coupon set as inactive, changing its status so it can no longer be redeemed. Returns: code (0 on success) and message confirming the status change. Required: coupon_set_id. - **create_a_zoho_billing_status_markasactive** — Bulk mark multiple coupon sets as active in Zoho Billing. Returns: code, message. Required: coupon_ids (comma-separated coupon set IDs, maximum 200 allowed). - **create_a_zoho_billing_status_markasinactive** — Mark multiple coupon sets as inactive in Zoho Billing. Returns: code, message. Required: coupon_ids. Maximum 200 IDs allowed. - **list_all_zoho_billing_customers** — List all customers in Zoho Billing, with optional status filtering. Returns: customer_id, display_name, email, company_name, currency_code, outstanding, and created_time for each customer. Defaults to 200 records per page. - **create_a_zoho_billing_customer** — Create a customer in Zoho Billing. Returns the created customer object including its customer_id, display_name, email, billing_address, and status. Required: display_name, email. A customer can also be created inline while creating a new subscription. - **get_single_zoho_billing_customer_by_id** — Get details of an existing customer in Zoho Billing by id. Returns code, message, and the full customer object including customer_id, display_name, email, contact details, billing and shipping addresses, currency, status, custom fields, and outstanding balance. Required: id. - **update_a_zoho_billing_customer_by_id** — Update an existing Zoho Billing customer by id (the customer_id). Returns the updated customer record with customer_id, display_name, email, status, billing_address, created_time, and updated_time. Required: id, display_name, and email. - **delete_a_zoho_billing_customer_by_id** — Delete an existing Zoho Billing customer by id (the customer_id). Returns: code, message. Required: id. - **get_single_zoho_billing_customers_reference_by_id** — Get a Zoho Billing customer by its Zoho CRM reference ID. Returns the matched customer object including customer_id, display_name, email, status, and created_time. Required: id (the CRM contact or account id serving as the reference) and reference_id_type (zcrm_account_id or zcrm_contact_id). - **list_all_zoho_billing_transactions** — List all transactions in Zoho Billing — invoices, payments, credits, and refunds. Returns transaction records including their id and attributes; the record fields vary by transaction type. - **create_a_zoho_billing_customer_markasactive** — Mark a customer as active in Zoho Billing, changing the customer's status to active. Returns: code, message. Required: customer_id. - **create_a_zoho_billing_customer_markasinactive** — Mark a Zoho Billing customer as inactive. Returns: code, message. A customer can only be marked inactive when no active subscription is associated with them. Required: customer_id. - **list_all_zoho_billing_customer_contactpersons** — List all contact persons of a customer in Zoho Billing. Returns code, message, and contact_persons records with contactperson_id, first_name, last_name, email, customer_id, created_time, and updated_time. Required: customer_id. - **create_a_zoho_billing_customer_contactperson** — Create a new contact person for a customer in Zoho Billing. Returns code, message, and the created contact_person with contactperson_id, first_name, last_name, email, customer_id, and created_time. Required: customer_id and email. - **update_a_zoho_billing_customer_contactperson_by_id** — Update the details of an existing contact person in Zoho Billing. Returns code, message, and the updated contact_person with contactperson_id, first_name, last_name, email, customer_id, and updated_time. Required: customer_id, id, and email. - **delete_a_zoho_billing_customer_contactperson_by_id** — Delete an existing contact person of a customer in Zoho Billing. Returns code and message confirming the deletion. Required: id and customer_id. - **get_single_zoho_billing_customer_contactperson_by_id** — Retrieve the details of an existing contact person in Zoho Billing. Returns code, message, and the contact_person record with contactperson_id, first_name, last_name, email, phone, customer_id, and created_time. Required: id and customer_id. - **list_all_zoho_billing_customer_cards** — List all active credit cards of a Zoho Billing customer. Returns: card_id, customer_id, status, last_four_digits, expiry_month, expiry_year, payment_gateway, first_name, last_name, street, city, state, zip, country, created_time, updated_time. Required: customer_id. - **delete_a_zoho_billing_customer_card_by_id** — Delete an existing credit card of a Zoho Billing customer by id. Returns: code and message confirming the card was deleted. Required: id (the card_id) and customer_id. - **get_single_zoho_billing_customer_card_by_id** — Get a single credit card of a Zoho Billing customer by id. Returns: card_id, customer_id, status, last_four_digits, expiry_month, expiry_year, payment_gateway, first_name, last_name, street, city, state, zip, country, created_time, updated_time. Required: id (the card_id) and customer_id. - **get_single_zoho_billing_customer_bankaccount_by_id** — Retrieve a specific bank account linked to a customer in Zoho Billing. Returns: code, message, bank_accounts. Required: id, customer_id. - **list_all_zoho_billing_estimates** — List all Zoho Billing quotes with pagination. Returns each quote's estimate_id, estimate_number, customer_id, customer_name, status, date, expiry_date, currency_code, total, created_time and last_modified_time. Use filter_by to restrict results to a single quote type. - **create_a_zoho_billing_estimate** — Create a quote for a customer in Zoho Billing. Returns the created quote including estimate_id, estimate_number, customer_id, status, line_items, sub_total and total. Required: customer_id. Set send to true to email the quote to its contact persons, or ignore_auto_number_generation to true to supply the quote number manually. - **get_single_zoho_billing_estimate_by_id** — Get the details of a specific quote (estimate) in Zoho Billing by id. Returns the estimate object including estimate_id, estimate_number, status, customer_name, date, expiry_date, sub_total, total, line_items, and created_time. Required: id. - **update_a_zoho_billing_estimate_by_id** — Update an existing quote in Zoho Billing by id. Returns the updated quote including estimate_id, estimate_number, status, customer_id, line_items, total and expiry_date. Required: id, customer_id. Set ignore_auto_number_generation to true to enter the quote number manually. - **delete_a_zoho_billing_estimate_by_id** — Delete an existing estimate (quote) in Zoho Billing by id. Returns: code, message. Required: id. - **create_a_zoho_billing_status_sent** — Mark a draft quote as sent in Zoho Billing. Returns: code, message confirming the estimate status change. Required: estimate_id. - **create_a_zoho_billing_status_accepted** — Mark a sent quote (estimate) as accepted in Zoho Billing once the customer has accepted it. Returns: code, message. Required: estimate_id. - **create_a_zoho_billing_status_declined** — Mark a sent Zoho Billing quote (estimate) as declined when the customer has rejected it. Returns: code, message confirming the status change. Required: estimate_id. - **get_single_zoho_billing_estimate_email_by_id** — Get the email content of a quote in Zoho Billing, including the subject and body that will be sent to the customer. Returns: code, message, subject, body, emailtemplates, to_contacts, from_emails, file_name, customer_id. Required: id, email_template_id. - **create_a_zoho_billing_estimate_email** — Email a quote to its customer in Zoho Billing. Returns: code, message. Required: estimate_id. If the request body is empty, the mail is sent with default content. - **create_a_zoho_billing_estimates_email** — Email multiple quotes (estimates) to their customers in Zoho Billing. Returns: code, message. Required: estimate_ids (comma separated quote ids). Maximum of 10 quotes can be sent at once. - **list_all_zoho_billing_estimates_pdfs** — Export quotes as PDF in zoho billing, up to 25 quotes in a single pdf. Returns: code, message. Required: estimate_ids (comma separated quote ids). - **list_all_zoho_billing_estimates_prints** — Bulk print quotes in zohobilling by exporting them as a pdf for printing. Returns: code, message. Required: estimate_ids (comma separated quote ids). Maximum of 25 quotes can be printed. - **list_all_zoho_billing_estimates_templates** — List all quote PDF templates in Zoho Billing. Returns: code, message, and templates containing template_name, template_id, and template_type. - **update_a_zoho_billing_estimate_template_by_id** — Update the PDF template associated with a Zoho Billing estimate (quote). Returns: code, message. Required: estimate_id and id (the estimate template id). - **update_a_zoho_billing_estimate_comment_by_id** — Update an existing comment on a Zoho Billing estimate (quote). Returns: code, message, comments. Required: estimate_id, comment_id, id. - **delete_a_zoho_billing_estimate_comment_by_id** — Delete a comment from a Zoho Billing estimate (quote). Returns: code and message confirming the comment has been deleted. Required: estimate_id, comment_id, id. - **create_a_zoho_billing_estimate_comment** — Add a comment to a Zoho Billing estimate (quote). Returns: code, message. Required: estimate_id. - **list_all_zoho_billing_estimate_comments** — List the complete history and comments of a Zoho Billing estimate (quote). Returns: code, message, comments. Required: estimate_id. - **list_all_zoho_billing_invoices** — List Zoho Billing invoices, optionally filtered by status or invoice date. Returns invoice records including invoice_id, invoice_number, status, customer_name, total, and balance. - **create_a_zoho_billing_invoice** — Create a Zoho Billing invoice for a customer. Returns the created invoice including invoice_id, invoice_number, status, total, and balance. Set ignore_auto_number_generation to true to supply a custom invoice_number. - **get_single_zoho_billing_invoice_by_id** — Get a single Zoho Billing invoice by id. Returns the full invoice record including invoice_id, invoice_number, status, invoice_items, total, and balance. Required: id. - **update_a_zoho_billing_invoice_by_id** — Update an existing Zoho Billing invoice by id. Returns the updated invoice including invoice_id, invoice_number, status, invoice_items, and total. Required: id. To remove a line item, remove it from invoice_items. - **delete_a_zoho_billing_invoice_by_id** — Delete a Zoho Billing invoice by id. Invoices with payments or credit notes applied cannot be deleted. Returns code and message confirming the deletion. Required: id. - **zoho_billing_customfields_bulk_update** — Update the values of custom fields on an existing invoice in Zoho Billing. Returns a confirmation containing code and message (e.g. "Custom Fields Updated Successfully"). Required: invoice_id and custom_fields (each entry must include label and value). - **create_a_zoho_billing_invoice_converttoopen** — Convert an invoice to open in zohobilling, changing its status so it can be paid or credited. Returns: code, message. Required: invoice_id. - **create_a_zoho_billing_invoice_void** — Void an invoice in Zoho Billing, marking its status as void; associated payments and credits are unassociated and return to customer credits. Returns code and message. Required: invoice_id. - **create_a_zoho_billing_invoice_email** — Email an invoice in Zoho Billing to one or more recipients. Returns the acknowledgement: code, message. Required: invoice_id, to_mail_ids, subject, body. - **create_a_zoho_billing_invoice_collect** — Collect a charge on a Zoho Billing invoice using an existing bank account or credit card. Returns code, message, and the payment record created by the collection, including its payment_mode, amount, status, and applied invoices. Required: invoice_id and account_id — pass card_id instead to charge a credit card. - **create_a_zoho_billing_invoice_writeoff** — Write off an invoice in Zoho Billing, marking the invoice as written off. Returns: code, message (e.g. "Invoice has been written off.."). Required: invoice_id. - **zoho_billing_invoice_addreses_bulk_update** — Update the shipping and billing address of an invoice in Zoho Billing. Returns the response code, message, and the invoice's updated billing_address and shipping_address. Required: invoice_id. - **create_a_zoho_billing_invoice_credit** — Apply multiple credit notes to a specific Zoho Billing invoice, associating each credit note with the amount to credit. Returns a confirmation message plus the list of applied credit notes. Required: invoice_id and the creditnote_id/amount_applied entries. - **create_a_zoho_billing_invoice_lineitem** — Add line items to a pending invoice in Zoho Billing to record usage charges. Returns: code, message, invoice (with invoice_id, status, invoice_items, total, balance). Required: invoice_id. Applies to pending invoices only. - **delete_a_zoho_billing_invoice_lineitem_by_id** — Delete a line item from a pending Zoho Billing invoice. Returns: code, message confirming the deletion. Required: id (the line item id) and invoice_id. - **create_a_zoho_billing_invoice_attachment** — Attach a file to an invoice in Zoho Billing. Returns: code, message. Allowed attachment extensions are gif, png, jpeg, jpg, bmp, and pdf. Required: invoice_id. - **create_a_zoho_billing_invoice_cancelwriteoff** — Cancel the write off amount of an invoice in Zoho Billing. Returns: code, message. Required: invoice_id. - **list_all_zoho_billing_subscriptions** — List Zoho Billing subscriptions, optionally filtered by customer_id, reference number, or subscription status/mode via filter_by. Returns each subscription with subscription_id, subscription_number, name, status, amount, next_billing_at, plan details, and nested customer info. - **create_a_zoho_billing_subscription** — Create a Zoho Billing subscription for a new customer by passing the customer object, or for an existing customer by passing customer_id. Returns the created subscription with subscription_id, subscription_number, status, amount, plan, addons, and customer. Requires a plan (with plan_code) plus either customer_id or the customer object. - **get_single_zoho_billing_subscription_by_id** — Get a Zoho Billing subscription by id. Returns the full subscription object including subscription_id, subscription_number, name, status, amount, billing dates, plan, addons, and customer details. Required: id. - **update_a_zoho_billing_subscription_by_id** — Update details of an existing Zoho Billing subscription by id, including plan, addons, coupon_code, auto_collect, reference_id, and payment terms. Returns the updated subscription with subscription_id, name, status, amount, plan, addons, and customer. Required: id. - **delete_a_zoho_billing_subscription_by_id** — Delete an existing Zoho Billing subscription by id. Returns: code, message. Required: id. - **zoho_billing_subscriptions_cancel** — Cancel a Zoho Billing subscription either immediately or at the end of the current term. Returns: code, message, and the subscription object including subscription_id, name, and status. Required: subscription_id. Optional cancel_at_end: true marks the subscription non_renewing, false cancels it immediately. - **zoho_billing_subscriptions_resume** — Resume a paused Zoho Billing subscription. Returns: code, message, and the subscription object including subscription_id, name, and status. Required: subscription_id. Optionally pass resume_at and reason in the request body. - **zoho_billing_subscriptions_pause** — Pause an active Zoho Billing subscription on a chosen date. Returns: code, message, and the subscription object including subscription_id, name, and status. Required: subscription_id, pause_at, and reason. - **create_a_zoho_billing_subscription_reactivate** — Reactivate a subscription in Zoho Billing; only subscriptions currently in non-renewing status can be reactivated. Returns: code, message, subscription. Required: subscription_id, billing_cycle. - **list_all_zoho_billing_subscription_scheduledchanges** — View the end-of-term changes scheduled for a Zoho Billing subscription. Returns: code, message, and data with the queued end-of-term changes. Required: subscription_id. - **zoho_billing_subscription_scheduledchanges_bulk_delete** — Delete the scheduled end-of-term changes queued for a Zoho Billing subscription. Returns: code, message. Required: subscription_id. - **list_all_zoho_billing_subscription_recentactivities** — List the recent activities associated with a zohobilling subscription, such as invoice creation events. Returns: code, message, and activities, where each activity includes activity_id, description, activity_time, and commented_by. Required: subscription_id. - **create_a_zoho_billing_subscription_buyonetimeaddon** — Buy a one-time addon for a Zoho Billing subscription, adding it to the subscription immediately. Returns: code, message, and the subscription record (with status, amount, addons, and next_billing_at). Required: subscription_id, addons (each item needs addon_code). - **create_a_zoho_billing_subscription_coupon** — Apply a coupon to an already-created Zoho Billing subscription. Returns the operation status: code (0 on success) and a confirmation message. Required: subscription_id, coupon_code. - **zoho_billing_subscription_coupons_bulk_delete** — Remove the coupon associated with a Zoho Billing subscription. Returns the operation status: code (0 on success) and a confirmation message. Required: subscription_id. - **update_a_zoho_billing_subscription_card_by_id** — Update the card associated with a Zoho Billing subscription; once updated, the past card will no longer be charged. Returns: code, message, and the updated subscription object (subscription_id, status, plan, card, auto_collect). Required: subscription_id and card_id (card_id is required when auto_collect is true and no other payment method is specified). - **zoho_billing_subscription_cards_bulk_delete** — Remove the card associated with a Zoho Billing subscription; the subscription will become an offline subscription. Returns: code, message. Required: subscription_id. - **create_a_zoho_billing_subscription_charge** — Add a one-time charge to a Zoho Billing subscription. Returns the outcome of the request as code and message. Required: subscription_id and amount. Set add_to_unbilled_charges to true to bill the amount later instead of immediately. - **create_a_zoho_billing_subscription_contactperson** — Add an existing contact person to a zohobilling subscription. Returns code, message, and the subscription object including its plan, customer, and contact_persons_associated details. Required: subscription_id. Only existing contact persons can be associated. - **create_a_zoho_billing_subscription_postpone** — Postpone a Zoho Billing subscription's renewal (billing) date to a future date, extending its term. Returns: code, message, and the updated subscription (subscription_id, name, status, next_billing_at). Renewal can only be postponed, not preponed. Required: subscription_id, renewal_at (future date, YYYY-MM-DD). - **update_a_zoho_billing_subscription_lineitem_by_id** — Update the description of a plan or addon line item on a zohobilling subscription. Returns: code, message. Required: id (the plan or addon code, e.g. basic-monthly) and subscription_id. - **create_a_zoho_billing_subscription_autocollect** — Switch a Zoho Billing subscription between Online and Offline auto-collection mode. Set auto_collect to true for online mode (the customer's card is charged automatically on every renewal) or false for offline mode. Returns: code, message. Required: subscription_id. - **update_a_zoho_billing_subscription_reference_by_id** — Update the reference id of a zohobilling subscription to easily identify and keep track of it. Returns: code, message, subscription (including subscription_id, status, reference_id). Required: subscription_id, reference_id. - **update_a_zoho_billing_subscription_salesperson_by_id** — Update the sales person assigned to a Zoho Billing subscription. Returns: code, message, and the updated subscription object including salesperson_id, salesperson_name, status, and plan. Required: subscription_id, salesperson_id, and salesperson_name. - **list_all_zoho_billing_subscription_customfields** — Get the custom fields associated with a Zoho Billing subscription. Returns: code, message, and customfields with customfield_id, label, and value. Required: subscription_id. - **update_a_zoho_billing_subscription_customfield_by_id** — Update the custom fields on a particular Zoho Billing subscription. Returns: code, message, and data with the updated customfield_id, label, value, data_type, and index. Required: subscription_id and custom_fields (each item needs label and value). - **list_all_zoho_billing_subscription_notes** — List all notes associated with a subscription in Zoho Billing. Returns: code, message, and notes where each note includes note_id, description, commented_by, and commented_time. Required: subscription_id. Use sort_column to sort by commented_time. - **create_a_zoho_billing_subscription_note** — Add a note to a subscription in Zoho Billing. Returns: code, message, and the created note containing note_id, subscription_id, description, commented_by, and commented_time. Required: subscription_id and description. - **delete_a_zoho_billing_subscription_note_by_id** — Delete a specific note from a Zoho Billing subscription. Returns the standard response envelope: code, message. Required: id (the note's unique identifier) and subscription_id. - **create_a_zoho_billing_subscription_extend** — Extend the billing cycles of a zohobilling subscription, optionally recording a payment along with the extension. Returns: code, message, and subscription (subscription_id, name, status). Required: subscription_id. - **create_a_zoho_billing_meteredbilling_enable** — Enable metered billing for a subscription in Zoho Billing. Returns the response code, a status message, and the subscription object including its subscription_id, name, and status. Required: subscription_id. - **create_a_zoho_billing_meteredbilling_disable** — Disable metered billing for a subscription in Zoho Billing. Returns: code, message, and the subscription (subscription_id, name, status). Required: subscription_id. - **get_single_zoho_billing_unbilledcharge_by_id** — Get an unbilled charge in Zoho Billing by id. Returns: code, message, and the unbilled_charge object including unbilled_charge_id, number, status, unbilled_charge_items, total, and created_time. Required: id. - **delete_a_zoho_billing_unbilledcharge_by_id** — Delete an unbilled charge in Zoho Billing by id. Returns: code, message confirming the unbilled charges have been deleted. Required: id. - **create_a_zoho_billing_unbilledcharge_createinvoice** — Convert unbilled charges to an invoice in Zoho Billing by manual intervention instead of waiting for the next renewal. Returns: code, message, and the created invoice object with invoice_id, number, status, invoice_items, total, balance, and created_time. Required: unbilled_charge_id. - **list_all_zoho_billing_payments** — List payments in Zoho Billing with pagination, filtering, search and sorting support. Returns code, message, and the payments collection where each payment includes payment_id, invoice_number, reference_number, date, mode, status, amount, and customer_name. Optional: filter_by (e.g. PaymentStatus.All). - **create_a_zoho_billing_payment** — Create a new payment in Zoho Billing and record it against one or more invoices. Returns code, message, and the created payment object including payment_id, payment_mode, amount, status, customer_name, and the invoices it was applied to. Required: customer_id, payment_mode, amount (each invoices item also requires invoice_id and amount_applied). - **get_single_zoho_billing_payment_by_id** — Get the details of an existing Zoho Billing payment by id. Returns code, message, and the payment object including payment_id, payment_mode, amount, status, customer_name, and the invoices it was applied to. Required: id. - **update_a_zoho_billing_payment_by_id** — Update an existing payment in Zoho Billing. Returns code, message, and the updated payment object including payment_id, payment_mode, amount, date, status, and customer_id. Required: id, customer_id, payment_mode, amount (each invoices item requires invoice_id and amount_applied). - **delete_a_zoho_billing_payment_by_id** — Delete an existing payment in Zoho Billing by id. Returns code and a message confirming the deletion (e.g. 'The payment has been deleted.'). Required: id. - **list_all_zoho_billing_paymentlinks** — List payment links in zohobilling. Returns each link's payment_link_id, payment_amount, status, url, customer_id, and created_time. - **create_a_zoho_billing_paymentlink** — Create a payment link for a customer in zohobilling. Returns the created link including payment_link_id, url, payment_amount, status, and expiry_time. Requires customer_id, payment_amount, and description. - **get_single_zoho_billing_paymentlink_by_id** — Get a payment link in zohobilling by id. Returns the full link object including payment_link_id, url, payment_amount, status, customer_id, and custom_fields. Required: id. - **update_a_zoho_billing_paymentlink_by_id** — Update an existing payment link in zohobilling by id. Returns the updated link including payment_link_id, expiry_time, description, status, and url. Required: id. - **delete_a_zoho_billing_paymentlink_by_id** — Delete an existing payment link in zohobilling by id. Returns: code, message. Required: id. - **zoho_billing_paymentlinks_cancel** — Cancel an existing payment link in Zoho Billing. Returns: code, message (e.g. "The payment link has been canceled."). Required: payment_id. - **list_all_zoho_billing_pricebooks** — List all pricebooks in Zoho Billing, with optional filtering by sales/purchase type, name search, and column sorting. Returns each pricebook's pricebook_id, name, description, currency_code, status, and last_modified_time. - **delete_a_zoho_billing_pricebook_by_id** — Delete a Zoho Billing pricebook by id. Returns: code, message. Required: id. - **create_a_zoho_billing_pricebook** — Create a new pricebook in Zoho Billing with custom rates for plans and addons. Returns the created pricebook including pricebook_id, name, currency_code, status, and pricebook_items. Requires name, currency_id, and type. - **get_single_zoho_billing_pricebook_by_id** — Retrieve a single Zoho Billing pricebook by id. Returns the full pricebook object including pricebook_id, name, currency_code, status, and pricebook_items with their custom rates. Required: id. - **update_a_zoho_billing_pricebook_item_by_id** — Update the pricebook rate for a specific item in a Zoho Billing pricebook. Returns: code, message, and the updated pricebook_item (pricebook_item_id, item_id, product_code, pricebook_rate). Required: pricebook_id, item_type, id. - **delete_a_zoho_billing_pricebook_item_by_id** — Remove a pricebook line item from a Zoho Billing pricebook. Returns: code, message. Required: pricebook_id, item_type, id. - **create_a_zoho_billing_creditnote** — Create a credit note in Zoho Billing for a customer refund. Returns the created credit note with creditnote_id, creditnote_number, status, total, balance, creditnote_items, and invoices. Requires customer_id, date, and creditnote_items (each item needs code and quantity). - **get_single_zoho_billing_creditnote_by_id** — Get a single Zoho Billing credit note by id. Returns the full credit note record including creditnote_id, creditnote_number, status, customer_name, total, balance, creditnote_items, invoices, taxes, and created_time. Required: id (the creditnote_id). - **delete_a_zoho_billing_creditnote_by_id** — Delete an existing credit note in Zoho Billing. Returns: code, message confirming the credit note was deleted. Required: id (the upstream creditnote_id, e.g. 90300000072369). - **create_a_zoho_billing_creditnote_email** — Email a credit note in Zoho Billing to a list of recipients. Returns: code, message (e.g. "Your creditnote has been sent."). Required: creditnote_id, to_mail_ids, subject, and body. - **create_a_zoho_billing_creditnote_void** — Void an existing credit note in zohobilling, marking it as void. Returns: code, message. Required: creditnote_id. - **create_a_zoho_billing_creditnote_converttoopen** — Open a voided credit note in Zoho Billing, converting its status back to open. Returns: code, message, and the updated credit_note object reflecting the new status. Required: creditnote_id. - **create_a_zoho_billing_creditnote_invoice** — Apply credits from a credit note to multiple invoices in zohobilling. Returns: code, message, and the invoices array with each entry's invoice_id and amount_applied. Required: creditnote_id and an invoices array where each entry needs invoice_id and amount_applied. - **list_all_zoho_billing_expenses** — List expenses recorded in Zoho Billing, with filters on description, reference_number, date, status, amount, account_name, customer_name, vendor_name, customer_id, paid_through_account_id and free-text search_text; filter_by narrows by status and sort_column orders results. Paginated with page and per_page (max 200). Returns each expense's expense_id, date, account_name, paid_through_account_name, description, currency_code, total, bcy_total, is_billable, reference_number, customer_id, customer_name, status, created_time, last_modified_time and custom_fields. - **create_a_zoho_billing_expense** — Record a new expense in Zoho Billing. Requires account_id (expense account) and amount; optional date, tax_id, is_inclusive_tax, is_billable with customer_id and project_id, currency_id and exchange_rate, reference_number, description, itemized line_items, custom_fields and regional tax fields. A receipt file can be attached separately as multipart. Returns the created expense with its expense_id. Required: account_id, amount. - **get_single_zoho_billing_expense_by_id** — Get a single expense from Zoho Billing by expense_id. Returns the full expense with account, date, amount and tax details (tax_id, tax_name, tax_percentage, tax_amount, is_inclusive_tax), totals (sub_total, total, bcy_total), currency and exchange_rate, billing links (is_billable, customer_id, project_id, invoice_id), status, receipt details, line_items, custom_fields and regional tax fields (GST for India, VAT for the UK). Required: id. - **update_a_zoho_billing_expense_by_id** — Update an existing expense in Zoho Billing by expense_id. Accepts the same fields as create (account_id, date, amount, tax settings, billable customer and project, currency, reference_number, description, line_items, custom_fields). Returns the updated expense. Required: id. - **delete_a_zoho_billing_expense_by_id** — Delete an expense from Zoho Billing by expense_id. Returns Zoho's code and message confirming the deletion. Required: id. - **list_all_zoho_billing_recurringexpenses** — List recurring expenses in zohobilling with pagination. Returns: id. Supports filters such as recurrence_name, status, account_id, customer_id, filter_by, search_text and sort_column. - **create_a_zoho_billing_recurringexpense** — Create a new recurring expense in zohobilling. Returns the created recurring expense object including its id, recurrence_name, status, next_expense_date, account_name and amount. - **get_single_zoho_billing_recurringexpense_by_id** — Get a recurring expense in zohobilling by id. Returns the full recurring expense details including its id, recurrence_name, status, next_expense_date, account_name and amount. Required: id. - **update_a_zoho_billing_recurringexpense_by_id** — Update an existing recurring expense in zohobilling by id. Returns the updated recurring expense object including its id, recurrence_name, status, next_expense_date, account_name and amount. Required: id. - **delete_a_zoho_billing_recurringexpense_by_id** — Delete a recurring expense in zohobilling by id. Returns the deleted recurring expense object (200 OK). Required: id. - **create_a_zoho_billing_status_stop** — Stop an active recurring expense in Zoho Billing. Returns: code, message confirming the recurring expense has been stopped. Required: recurring_expense_id. - **create_a_zoho_billing_status_resume** — Resume a stopped recurring expense in zohobilling, reactivating its billing schedule. Returns: code, message. Required: recurring_expense_id. - **list_all_zoho_billing_recurringexpense_expenses** — List child expenses generated from a recurring expense in Zoho Billing. Returns: code, message, and expensehistory entries with expense_id, date, account_name, customer_name, total, status, vendor_name, and paid_through_account_name. Required: recurring_expense_id. - **create_a_zoho_billing_creditnote_refund** — Create a refund on a Zoho Billing credit note. Returns code, message, and the refund object including refund_id, date, amount, refund_mode, status, and creditnote details. Required: creditnote_id, amount. - **create_a_zoho_billing_payment_refund** — Refund a payment in Zoho Billing — a new credit note is created for the refund amount and the refund is issued against it. Returns: code, message, and the refund object (refund_id, amount, refund_mode, status, creditnote, autotransaction, currency_code). Required: payment_id, amount. - **get_single_zoho_billing_creditnotes_refund_by_id** — Get details of an existing credit note refund in Zoho Billing. Returns: description. Required: id (the refund's refund_id). - **get_single_zoho_billing_hostedpage_by_id** — Retrieve a specific Zoho Billing hosted page by id. Returns: url. Required: id (hostedpage_id). - **list_all_zoho_billing_hostedpages** — List all Zoho Billing hosted pages. Returns a collection of pages with hostedpage_id, status, url, action, expiring_time, and created_time. - **create_a_zoho_billing_hostedpages_newsubscription** — Create a Zoho Billing hosted page for a new subscription for a new customer (pass customer) or an existing customer (pass customer_id). Returns code, message, and the hostedpage object with hostedpage_id, url, action, status, expiring_time, and created_time. Required: plan (with plan_code), plus customer or customer_id. Hosted pages expire within one hour. - **create_a_zoho_billing_hostedpages_updatesubscription** — Create a hosted page in Zoho Billing for updating an existing subscription. Returns: code, message, and the hostedpage object with hostedpage_id, status, url, action, expiring_time, and created_time. Required: subscription_id. - **create_a_zoho_billing_hostedpages_updatecard** — Create a hosted page in Zoho Billing for updating a subscription's card information. Returns: code, message, and a hostedpage object containing hostedpage_id, url, status, action, expiring_time, and created_time. Hosted pages expire within one hour. Required: subscription_id. - **create_a_zoho_billing_hostedpages_buyonetimeaddon** — Create a Zoho Billing hosted page for buying a one-time addon for a subscription. Returns code, message, and the hostedpage object with hostedpage_id, status, url, action, expiring_time, created_time, and custom_fields. Required: subscription_id, addons, addon_code. Hosted pages expire within one hour. - **create_a_zoho_billing_hostedpages_addpaymentmethod** — Create a Zoho Billing hosted page where a customer can securely add a payment method. Returns code, message, and a hostedpage object with hostedpage_id, status, url, and expiring_time. Required: customer_id. Hosted pages expire within one hour. - **create_a_zoho_billing_hostedpages_invoicepayment** — Create a hosted page in Zoho Billing for recording an invoice payment for a subscription. Returns: code, message, and the hostedpage object (hostedpage_id, url, status). Required: invoice_id. - **create_a_zoho_billing_hostedpages_updatepaymentmethod** — Create a Zoho Billing Hosted Payment Page that lets a customer update their card, bank account (ACH), or PayPal details. Returns: code, message, and hostedpage (hostedpage_id, status, url, action, expiring_time, created_time). Required: one of card_id (card change), account_id (ACH change), or paypal_id (PayPal change), depending on the payment method being updated. - **list_all_zoho_billing_projects** — List all projects in Zoho Billing with pagination. Returns: code, message, and a projects array with project_id, project_name, customer_name, status, billing_type, rate, and created_time. Default 200 per page. - **create_a_zoho_billing_project** — Create a new project in Zoho Billing. Returns: code, message, and the created project object with project_id, project_name, status, billing_type, rate, and created_time. Required: project_name, customer_id, billing_type, users. rate is also mandatory when billing_type is fixed_cost_for_project or based_on_project_hours. - **get_single_zoho_billing_project_by_id** — Get the details of a specific project in Zoho Billing by id. Returns: code, message, and the project object including project_id, project_name, customer_id, customer_name, currency_code, status, billing_type, rate, hours and amount totals, created_time, tasks, and users. Required: id. - **update_a_zoho_billing_project_by_id** — Update the details of an existing project in Zoho Billing by id. Returns: code, message, and the updated project object with project_id, project_name, status, billing_type, rate, and created_time. Required: id, project_name, customer_id, billing_type, users. rate is also mandatory when billing_type is fixed_cost_for_project or based_on_project_hours. - **delete_a_zoho_billing_project_by_id** — Delete an existing project in Zoho Billing by id. Returns: code and message confirming the deletion. Required: id. - **zoho_billing_projects_clone** — Clone the settings of an existing project in Zoho Billing to create a new project with the same configuration. Returns: code, message, and project (the cloned project object with project_id, project_name, billing_type, rate, tasks, and users). Required: project_id. - **create_a_zoho_billing_project_active** — Activate a project in zohobilling by marking it as active. Returns: code, message. Required: project_id. - **create_a_zoho_billing_project_inactive** — Deactivate a project in Zoho Billing by marking it inactive. Returns: code, message. Required: project_id. - **list_all_zoho_billing_project_users** — List all users associated with a zohobilling project. Returns: user_id, is_current_user, user_name, email, user_role, status, rate, budget_hours. Required: project_id. - **create_a_zoho_billing_project_user** — Assign an existing user to a zohobilling project. Returns: user_id, is_current_user, user_name, email, user_role, status, rate, budget_hours. Required: project_id and user_id. - **update_a_zoho_billing_project_user_by_id** — Update details of a user assigned to a zohobilling project, such as name, role, rate, and budgeted hours. Returns: user_id, is_current_user, user_name, email, user_role, status, rate, budget_hours. Required: id (the user's user_id) and project_id. - **delete_a_zoho_billing_project_user_by_id** — Remove a user from a zohobilling project. Returns a success acknowledgement with code and message. Required: project_id and id (the user's user_id). - **get_single_zoho_billing_project_user_by_id** — Get details of a single user assigned to a zohobilling project. Returns: user_id, is_current_user, user_name, email, user_role, status, rate, budget_hours. Required: id (the user's user_id) and project_id. - **create_a_zoho_billing_users_invite** — Invite a user to a Zoho Billing project by email. Returns: code, message, user_id, user_name, email, user_role. Required: project_id, user_name, email. - **delete_a_zoho_billing_project_comment_by_id** — Delete a comment on a project in Zoho Billing by id. Returns: code, message. Required: project_id, id. - **create_a_zoho_billing_project_comment** — Post a comment to a project in Zoho Billing. Returns the added comment with project_id, comment_id, description, commented_by, date, and time. Required: project_id, description. - **list_all_zoho_billing_project_comments** — List comments for a project in Zoho Billing. Returns each comment with project_id, comment_id, description, commented_by, date, and time. Required: project_id. - **list_all_zoho_billing_project_invoices** — List invoices created for a project in Zoho Billing. Returns each invoice's invoice_number, date, total, balance, and created_time, with sorting limited to those fields. Required: project_id. - **list_all_zoho_billing_project_tasks** — List all tasks added to a project in Zoho Billing. Returns: code, message, and the tasks collection with task_id, task_name, project_name, customer_name, billed_hours, and log_time per task. Required: project_id. - **create_a_zoho_billing_project_task** — Add a new task to a project in Zoho Billing. Returns: code, message, and the created task with task_id, task_name, project_name, customer_name, billed_hours, and log_time. Required: project_id and task_name. - **update_a_zoho_billing_project_task_by_id** — Update the details of an existing project task in Zoho Billing. Returns: code, message, and the updated task with task_id, task_name, project_name, billed_hours, and log_time. Required: id, project_id, and task_name. - **delete_a_zoho_billing_project_task_by_id** — Delete a task added to a project in Zoho Billing. Returns: code and message confirming the deletion. Required: id and project_id. - **get_single_zoho_billing_project_task_by_id** — Get the details of a single project task in Zoho Billing. Returns: code, message, task. Required: id and project_id. - **list_all_zoho_billing_tasks** — List Zoho Billing tasks. Returns each task with task_id, title, status, priority, due_date, task_number, owner_name, and completion_percentage. Filter by status, priority, contact, owner, dates, or search_text; 200 records per page by default. - **create_a_zoho_billing_task** — Create a task in Zoho Billing with a title, owners, due date, contact, priority, reminder, and custom fields. Returns the created task including task_id, title, status, priority, and due_date. - **zoho_billing_tasks_bulk_update** — Bulk update Zoho Billing tasks by sending an array of task objects, each identified by task_id. Returns code, message, and the updated tasks with task_id, title, status, and priority. Required: bulk_update. - **zoho_billing_tasks_bulk_delete** — Delete Zoho Billing tasks in bulk. Returns code and message confirming the deletion. Required: task_ids (comma-separated task IDs). - **get_single_zoho_billing_task_by_id** — Get a single Zoho Billing task by id. Returns the full task record including task_id, title, status, priority, due_date, owners, reminder, and completion_percentage. Required: id. - **update_a_zoho_billing_task_by_id** — Update a Zoho Billing task by id with the task attributes to change. Returns the confirmation code and message. Required: id. - **delete_a_zoho_billing_task_by_id** — Delete a Zoho Billing task by id. Returns the confirmation code and message. Required: id. - **update_a_zoho_billing_task_percentage_by_id** — Update the completed percentage of a task in zohobilling. Returns: code, message. Required: task_id and completion_percentage. - **create_a_zoho_billing_task_markasopen** — Mark a task as open in Zoho Billing. Returns: code, message, and task — the updated task object with its status set to open. Required: task_id. - **create_a_zoho_billing_task_markasongoing** — Mark a Zoho Billing task as ongoing by id. Returns a status confirmation containing code and message. Required: task_id. - **create_a_zoho_billing_task_markascompleted** — Mark a task as completed in Zoho Billing. Returns a status confirmation: code and message (e.g. "Task status updated"). Required: task_id. - **delete_a_zoho_billing_task_comment_by_id** — Delete a comment of a task in Zoho Billing by id. Returns: code, message. Required: task_id, id. - **create_a_zoho_billing_task_comment** — Add a comment to a task in Zoho Billing. Returns the status code, message, and the created comment object including its comment_id, description, commented_by, comment_type, and date. Required: task_id, description. - **list_all_zoho_billing_task_comments** — List comments of a task in Zoho Billing. Returns comments with comment_id, description, commented_by, comment_type, date, and operation_type. Required: task_id. - **create_a_zoho_billing_task_attachment** — Upload an attachment file to a task in Zoho Billing. Returns: code, message, documents (each with file_name, file_type, file_size, document_id). Required: task_id. Allowed file extensions: gif, png, jpeg, jpg, bmp, pdf, xls, xlsx, doc, docx, xml, csv, txt, tif and tiff. - **delete_a_zoho_billing_task_document_by_id** — Delete a document of a task in Zoho Billing by id. Returns: code, message. Required: task_id, id. - **get_single_zoho_billing_task_document_by_id** — Get a document of a task in Zoho Billing by id. Returns code, message, and the document object including file_name, file_type, file_size, document_id, attachment_order, and can_show_in_portal. Required: task_id, id. - **list_all_zoho_billing_projects_timeentries** — List time entries in Zoho Billing with pagination. Returns: code, message, and time_entries — each entry includes time_entry_id, project_name, task_name, user_name, log_date, log_time, is_billable, billed_status, and created_time. No required parameters. - **create_a_zoho_billing_projects_timeentry** — Log a new time entry in Zoho Billing against a project, task, and user. Returns: code, message, and time_entry with time_entry_id, project_name, log_date, log_time, is_billable, and billed_status. Requires project_id, task_id, user_id, and log_date; provide either log_time or both begin_time and end_time. - **zoho_billing_projects_timeentries_bulk_delete** — Delete multiple time entries in bulk in Zoho Billing. Returns: code and message confirming 'The selected timesheet entries have been deleted'. - **get_single_zoho_billing_projects_timeentry_by_id** — Get a single time entry in Zoho Billing by id. Returns: code, message, and time_entry with time_entry_id, project_id, task_id, user_id, log_date, log_time, is_billable, billed_status, notes, and created_time. Required: id. - **update_a_zoho_billing_projects_timeentry_by_id** — Update a logged time entry in Zoho Billing by id. Returns: code, message, and the updated time_entry with time_entry_id, project_name, log_date, log_time, is_billable, and billed_status. Requires id, project_id, task_id, user_id, and log_date; provide either log_time or both begin_time and end_time. - **delete_a_zoho_billing_projects_timeentry_by_id** — Delete a logged time entry in zohobilling by id. Returns the deletion confirmation including code and message. Required: id. - **create_a_zoho_billing_timer_start** — Start the timer for a Zoho Billing time entry to begin tracking time spent. Returns: code, message, and time_entry (time_entry_id, project_name, task_name, timer_started_at, timer_duration_in_seconds). Required: time_entry_id. - **create_a_zoho_billing_timer_stop** — Stop the currently running timer in Zoho Billing, for example when taking a break or leaving. Returns: code, message, and time_entry including time_entry_id, project_name, task_name, log_time, billed_status, and timer duration fields. - **list_all_zoho_billing_timeentries_runningtimers** — Get the currently running timer for the authenticated user in Zoho Billing. Returns: code, message, time_entry. No caller parameters required. - **get_single_zoho_billing_event_by_id** — Get details of an existing event in Zoho Billing by id. Returns: code, message, and the event object with event_id, event_type, event_time, payload, and webhooks. Required: id (event_id). Only events created in the last 180 days are accessible. - **list_all_zoho_billing_events** — List all events recorded in Zoho Billing, such as subscription, invoice, and payment lifecycle events. Returns: code, message, and the events list with event_id, event_type, and event_time per event. Only events created in the last 180 days are accessible. - **list_all_zoho_billing_settings_taxes** — List all taxes configured in Zoho Billing. Returns: code, message, and taxes — each tax includes tax_id, tax_name, tax_percentage, tax_type, tax_authority_id, tax_authority_name, is_default_tax, and is_editable. Default 200 per page. - **list_all_zoho_billing_settings_taxexemptions** — List tax exemptions configured in Zoho Billing. Returns each exemption with its description, tax_exemption_id, tax_exemption_code, and type (e.g., customer). - **list_all_zoho_billing_settings_taxauthorities** — List the tax Authorities configured in zohobilling. Returns: code, message, and tax_authorities, where each authority includes description, tax_authority_id, and tax_authority_name. - **list_all_zoho_billing_preferences_churnmessages** — List the Advanced Churn Message preferences for a zohobilling organization. Returns: code, message, and churn_messages_settings including is_advanced_version, is_reason_mandatory, and the churn_messages list (label, index, churn_message_id). - **list_all_zoho_billing_reportingtags** — List all reporting tags in Zoho Billing in the preferred order that you can set. Returns reporting_tags, each with tag_id, tag_name, tag_order, description, is_active, is_mandatory, is_class, and is_draft. - **create_a_zoho_billing_reportingtag** — Create a reporting tag in Zoho Billing with its enabled entities and multi-preference entities. Returns the created tag under `tag` including tag_id, tag_name, description, is_mandatory, entities, and multi_preference_entities. Required: tag_name, entities, multi_preference_entities. - **update_a_zoho_billing_reportingtag_by_id** — Update a reporting tag in Zoho Billing by id. Returns the updated tag under `tag` including tag_id, tag_name, description, is_mandatory, entities, and multi_preference_entities. Required: id, tag_name, entities, multi_preference_entities. - **delete_a_zoho_billing_reportingtag_by_id** — Delete a reporting tag in Zoho Billing by id. Deletion fails if the tag is used in transactions, custom views, or workflows. Returns the message confirming the tag was deleted successfully. Required: id. - **zoho_billing_reportingtag_options_bulk_update** — Create, update, or delete the options of a Zoho Billing reporting tag and arrange them in a hierarchical structure. Returns: code, message, options. Required: tag_id. Options cannot be nested beyond five levels and any option can have at most 500 child options. - **zoho_billing_reportingtag_criterias_bulk_update** — Update the visibility conditions (filters) of a Zoho Billing reporting tag by setting other tags or locations as filters for its options. Returns: message. Required: tag_id, organization_id, criteria_tags, options. - **create_a_zoho_billing_reportingtag_active** — Activate a reporting tag in zohobilling so it can be used on the entities you allowed. A newly created tag starts in draft state; this call marks it ready. Returns: message. Required: tag_id. - **create_a_zoho_billing_reportingtag_inactive** — Deactivate a reporting tag in zohobilling by marking it inactive. Returns: message.g. "The reporting tag has been deactivated."). Required: tag_id. - **list_all_zoho_billing_reportingtags_options** — Get the options and their criteria details of a reporting tag in Zoho Billing. Returns: description. Required: organization_id, tag_id. Max 200 options per page. - **list_all_zoho_billing_options_alls** — List all options for a reporting tag in Zoho Billing, including the 'untagged' option when show_untagged is set. Returns: code, message, results (each with option_id, option_name, depth). Required: tag_id. - **zoho_billing_reportingtags_reorders_bulk_update** — Reorder the reporting tags in your Zoho Billing organization; the new order is followed in transactions and reports. Returns code, message, and the reordered tags with tag_id, tag_name, and tag_order. Required: organization_id (query), tag_ids. - **list_all_zoho_billing_settings_modules** — List all custom module configurations in Zoho Billing, including their field, permission, and portal settings definitions. Returns: code, message, module. - **create_a_zoho_billing_settings_module** — Create a new custom module configuration in Zoho Billing, defining its name, fields, permissions, and visibility settings. Returns the created module with module_id, module_name, module_api_name, is_active, singular_name, and plural_name. Required: module_name, plural_name. - **get_single_zoho_billing_settings_module_by_id** — Get the configuration details of a specific custom module in Zoho Billing. Returns: code, message, module. Required: id (the custom module's API name, e.g. cm_debtor) and organization_id. - **zoho_billing_settings_modules_bulk_update** — Update the configuration of an existing custom module in Zoho Billing, identified by its module_api_name. Returns the updated module with module_id, module_name, module_api_name, is_active, singular_name, and plural_name. Required: module_api_name, module_name, plural_name. - **zoho_billing_settings_modules_bulk_delete** — Delete an existing custom module configuration and all its records in Zoho Billing. Returns: code, message (e.g. "The custom module has been deleted."). Required: module_api_name and organization_id. - **list_all_zoho_billing_custom_module_records** — List records of a Zoho Billing custom module, filterable by custom view, status, and text search. Returns: code, message, module_record (module_record_id, record_name, created_time, last_modified_time, cf_* custom fields), and page_context. Required: module_name. - **create_a_zoho_billing_custom_module_record** — Create a new record in a Zoho Billing custom module. Returns: code, message, and the created module_record (module_record_id, module_api_name, record_name, created_time, last_modified_time, plus cf_* custom fields). Required: module_name, record_name. - **update_a_zoho_billing_custom_module_record_by_id** — Bulk update existing Zoho Billing custom module records by passing their IDs in module_record_id. Returns: code, message, and the updated module_record array (module_record_id, record_name, created_time, cf_* fields, per-record code and message). Required: id, module_name, record_name. - **delete_a_zoho_billing_custom_module_record_by_id** — Delete a Zoho Billing custom module record by id. Returns: code, message. Required: id, module_name. - **zoho_billing_custom_module_records_bulk_delete** — Delete multiple Zoho Billing custom module records by comma-separated IDs. Returns: code, message. Required: module_name. Maximum 200 record_ids per call. - **zoho_billing_custom_module_records_bulk_update** — Bulk update existing custom module records in Zoho Billing. Returns: code, message, module_record. Required: module_name, organization_id, record_name. - **get_single_zoho_billing_custom_module_record_by_id** — Get the details of an individual record in a custom module in Zoho Billing. Returns: code, message, module_record, module_record_hash, users. Required: module_name, organization_id, id. - **list_all_zoho_billing_recurringexpense_comments** — List the history and comments of a recurring expense in Zoho Billing. Returns each entry with comment_id, description, commented_by, operation_type, date, and time. Required: recurring_expense_id. - **create_a_zoho_billing_reportingtag_markdefault** — Mark an option as the default option for a reporting tag in Zoho Billing, or clear the current default by sending default_option_id empty. Returns: code, message. Required: reportingtag_id, default_option_id. - **create_a_zoho_billing_reportingtag_option_active** — Mark a reporting tag's option as active in Zoho Billing so it can be used on the entities you've enabled. Returns: message. Required: tag_id, option_id, organization_id. - **create_a_zoho_billing_reportingtag_option_inactive** — Mark an option of a reporting tag as inactive in Zoho Billing, removing it from use on entities. Returns a confirmation message. Required: tag_id, option_id, organization_id. - **create_a_zoho_billing_crm_account_import** — Import a customer into Zoho Billing from a Zoho CRM account ID, creating the corresponding billing customer record. Returns: code, message, data. Requires the Zoho CRM integration to be configured with either "Accounts and Contacts" or "Accounts only" sync. Required: crm_account_id. - **create_a_zoho_billing_crm_contact_import** — Import a customer into Zoho Billing from Zoho CRM by their CRM contact ID. Returns: code, message, data. Requires the Zoho CRM integration to be configured for contact sync. Required: crm_contact_id. ## How it works 1. **Link your customer's Zoho Billing account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Zoho Billing.** The Proxy API is a 1-to-1 mapping of the Zoho Billing API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Automate Deal-to-Cash from Your Vertical CRM** — Let your CRM users convert closed deals into Zoho Billing estimates, subscriptions, and hosted checkout links automatically. Eliminates the manual handoff between sales and finance teams. - **Embed Billing Controls in Customer Success Tools** — Give CS reps the ability to pause subscriptions, issue credit notes, process refunds, and view MRR directly inside your platform. Removes the need to switch to Zoho Billing for routine account management. - **Power Usage-Based Billing for Product-Led SaaS** — Stream metered usage from your analytics or infrastructure platform into Zoho Billing as unbilled charges, so your customers can bill end users accurately without building their own ledger. - **Sync Field Hours and Expenses into Client Invoices** — For field service, PSA, or agency tools, push time entries and expense receipts directly into Zoho Billing projects so your users' invoices reflect every billable hour and reimbursable cost. - **Offer Native Quote-to-Subscription Workflows** — Let your users generate estimates, send them for approval, and convert accepted quotes into active subscriptions with hosted payment pages — all from inside your product. ## What you can build - **Subscription Lifecycle Management** — Create, pause, resume, cancel, reactivate, and extend subscriptions programmatically, including mid-cycle add-on purchases and plan changes. - **Hosted Payment Page Generation** — Generate secure, PCI-compliant URLs for new subscriptions, card updates, invoice payment, and one-time add-on purchases without handling card data yourself. - **Metered & Usage-Based Billing Pipeline** — Enable metered billing on subscriptions and push unbilled charges from your platform so usage flows into the next invoice automatically. - **Estimate-to-Invoice Automation** — Create estimates, email them to customers, track accept/decline status, and convert them into invoices or subscriptions. - **Refunds, Credit Notes & Dunning Actions** — Issue credit notes, process refunds against payments, write-off invoices, and void transactions directly from your UI. - **Project Time & Expense Sync** — Create projects, log time entries with start/stop timers, and attach expenses with receipts so billable work rolls up into Zoho Billing invoices. ## FAQs ### How does authentication work for Zoho Billing? Zoho Billing uses OAuth 2.0. Truto handles the full OAuth flow — your users click connect, authorize their Zoho account, and Truto manages token storage and refresh. You never deal with client credentials or refresh logic. ### Does Truto support multiple Zoho data centers (US, EU, IN, AU)? Yes. Zoho operates region-specific data centers and Truto routes API calls to the correct domain based on where your end user's Zoho organization is hosted, so you don't need to maintain region-specific logic. ### How are multiple Zoho Billing organizations handled per connected account? Zoho users can own multiple organizations under a single login. You can call list_all_zoho_billing_organizations to enumerate them and scope subsequent calls to the correct organization ID. ### Can I support custom fields and custom modules? Yes. Zoho Billing supports custom fields on records like subscriptions and invoices, plus fully custom modules. Truto exposes tools for listing, creating, and bulk-updating custom module records and custom fields. ### How do I handle metered or usage-based billing? Enable metered billing on a subscription with create_a_zoho_billing_meteredbilling_enable, then push usage with unbilled charge tools before the billing cycle closes. Zoho Billing will roll these charges into the next invoice automatically. ### What's the best way to capture payment details without handling PCI data? Use the hosted pages tools to generate a secure URL for new subscriptions, card updates, or invoice payment. Send that URL to the end customer — Zoho Billing collects and tokenizes the card on their hosted checkout. ### How fresh is the data — does Truto support webhooks or events? You can poll list_all_zoho_billing_events to pick up changes like failed payments, subscription updates, and invoice events. For near real-time updates, combine event polling with targeted fetches on the affected resource IDs.