Zoho Billing
API integration

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.