Bulk update subscription prices

Last updated: February 10, 2026

Update the price of multiple subscriptions in a single API call. Useful for adjusting prices based on currency exchange rates, seasonal pricing, or promotional changes.

Endpoint

POST https://api.rebill.com/v3/subscriptions/bulk-update-price

Authentication

Include your Secret API key in the x-api-key header.

--header 'x-api-key: your-secret-api-key'

Update methods

You can update subscriptions by specifying either subscription IDs or plan IDs.

Method 1: Update by subscription IDs

Updates only the specific subscriptions listed in the subscriptionIds array.

Request body parameters:

  • subscriptionIds (array, required): List of subscription IDs to update

  • amount (number, required): New price amount

Example:

curl --location --request POST 'https://api.rebill.com/v3/subscriptions/bulk-update-price' \--header 'Content-Type: application/json' \--header 'x-api-key: your-secret-api-key' \--data-raw '{
  "subscriptionIds": ["sub_xxx", "sub_yyy"],
  "amount": 123456.00
}'

Method 2: Update by plan IDs

Updates all active subscriptions generated from the specified plans in the planId array.

Request body parameters:

  • planId (array, required): List of plan IDs

  • amount (number, required): New price amount

Example:

bash

curl --location --request POST 'https://api.rebill.com/v3/subscriptions/bulk-update-price' \--header 'Content-Type: application/json' \--header 'x-api-key: your-secret-api-key' \--data-raw '{
  "planId": ["pl_xxx", "pl_yyy"],
  "amount": 123456.00
}'

When the price change applies

The new price applies to the next scheduled billing cycle for each subscription.

Example:

  • Subscription next charge date: March 15, 2026

  • You update the price on March 10, 2026

  • The new price will be charged on March 15, 2026

Common use cases

Currency exchange adjustments: Update subscription prices at the start of each month based on USD exchange rates for local currencies.

Price corrections: Fix incorrect pricing across multiple subscriptions in one operation.

Important notes

When using planId: All active subscriptions associated with that plan will be updated. Verify this is the intended behavior before executing.

No update limit: There is no limit on the number of subscriptions you can update in a single request. However, we recommend testing with a small batch first.

Test before bulk updates: Run a test with a reduced number of subscriptions to validate the behavior before performing large-scale updates.

Response

The API returns a success confirmation once the bulk update is processed.

Success response:

{  "success": true,  "updated": 250,  "message": "Subscription prices updated successfully"}

Need help?

If you have questions or need assistance with bulk price updates, contact support@rebill.com.