Zoho Billing icon

Zoho Billing

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

Actions24

Plan → Create

AI-generated

Summary

Creates a new recurring plan in Zoho Billing by POSTing to /billing/v1/plans within the selected organization, and returns the API's response for the created plan.

Inputs

  • organizationId (required) — Zoho organization, chosen from a list loaded from the API. Sent as the X-com-zoho-subscriptions-organizationid header.
  • planCode (required) — Unique code for the plan, sent as plan_code.
  • planName (required) — Display name of the plan, sent as name.
  • planRecurringPrice (required) — Recurring price per interval, sent as recurring_price.
  • planInterval (required) — Number of interval units per billing cycle (minimum 1).
  • planIntervalUnit — Months or Years (default months), sent as interval_unit.
  • planProductId (required) — ID of the Zoho product the plan belongs to, sent as product_id.
  • planBillingCycles — Number of billing cycles. Defaults to -1, which in Zoho typically means unlimited. Always sent.
  • planTrialPeriod — Trial length in days (default 0). Always sent.
  • planSetupFee — One-time setup fee (default 0). Always sent.
  • planDescription — Plan description. Only sent if non-empty after trimming.
  • planStoreMarkupDescription — Store markup description. Only sent if non-empty after trimming.

Output shape

One output item per input item, containing the JSON response from Zoho Billing for the created plan (typically a code/message and a plan object).

Each output is paired to its input item. Authentication uses the zohoBillingOAuth2Api credential and the regional API base URL is derived from it. If Continue On Fail is enabled, a failed item yields {error: message} instead of stopping the workflow.

Examples

Example 1: Create a monthly $29 plan with a 14-day trial for an existing product

Organization selected; Plan Code 'pro-monthly'; Plan Name 'Pro'; Recurring Price 29; Interval 1; Interval Unit months; Product ID from Zoho; Trial Period 14; Billing Cycles -1.

Example 2: Create an annual plan with a setup fee

Plan Code 'ent-yearly'; Recurring Price 990; Interval 1; Interval Unit years; Setup Fee 100; Description 'Enterprise annual'.

Links

Discussion