POST /v1/plans/{plan}

Updates the specified plan by setting the values of the parameters passed. Any parameters not provided are left unchanged. By design, you cannot change a plan’s ID, amount, currency, or billing cycle.

Servers

Path parameters

Name Type Required Description
plan String Yes

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/x-www-form-urlencoded"

Request body fields

Name Type Required Description
active Boolean No

Whether the plan is currently available for new subscriptions.

nickname String No

A brief description of the plan, hidden from customers.

trial_period_days Integer No

Default number of trial days when subscribing a customer to this plan using trial_from_plan=true.

expand[] Array No

Specifies which fields in the response should be expanded.

metadata No

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

product String No

The product the plan belongs to. This cannot be changed once it has been used in a subscription or subscription schedule.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.