Zoho Billing icon

Zoho Billing

Consume Zoho Billing API v1 (Subscriptions, Plans, Addons, Coupons, Invoices)

Actions24

Plan → Update

AI-generated

Summary

Updates an existing Zoho Billing plan, identified by its plan code, by sending a PUT request with the plan's name, pricing, interval, and optional descriptive fields.

Inputs

  • organizationId (required) — Zoho organization, chosen from a list loaded from the API. Sent as the X-com-zoho-subscriptions-organizationid header.
  • planCode (required) — Code of the plan to update. It is used in the URL (PUT /plans/{planCode}).
  • planName (required) — Plan name, sent as name.
  • planRecurringPrice (required) — Recurring price, sent as recurring_price.
  • planInterval (required) — Billing interval length (minimum 1), sent as interval.
  • planIntervalUnit — Months or Years (default months), sent as interval_unit.
  • planBillingCycles — Number of billing cycles, sent as billing_cycles. The default of -1 is always sent.
  • planTrialPeriod — Trial length in days (minimum 0), sent as trial_period.
  • planSetupFee — One-time setup fee, sent as setup_fee.
  • planDescription — Plan description. Sent only if non-empty after trimming.
  • planStoreMarkupDescription — Store markup description. Sent only if non-empty after trimming.

Output shape

One output item per input item, containing the JSON response from Zoho Billing for the updated plan. In the Zoho API this is typically a code/message plus a plan object.

The plan code and product ID cannot be changed here. The required numeric fields and the defaulted fields (interval unit, billing cycles, trial period, setup fee) are always sent. Leaving them at their defaults may therefore overwrite the plan's existing values. With Continue On Fail enabled, a failed item returns {error: message} instead of stopping the run.

Examples

Example 1: Raise the monthly price of an existing plan to 29.

Select the organization. Set Plan Code to 'pro-monthly', Plan Name to 'Pro', Recurring Price to 29, Interval to 1 and Interval Unit to Months. Set the remaining fields to match the plan's current values so they aren't overwritten.

Links

Discussion