"Sorry, the URL or some of the parameters are not valid" error with Hosted Pages API

Problem Statement

You receive the error "Sorry, the URL or some of the parameters are not valid" when using the Hosted Pages API.

Solution

Check the following common causes:

1. Parameter order

For APIs such as "Checkout existing for items", the plan's item price ID must be passed before the add-on's. Example:

subscription_items[item_price_id][0]=Basic-Test-USD-Monthly
subscription_items[item_price_id][1]=cbdemo_analytics-additional-users-USD-Monthly

The same order applies when creating a Hosted page URL.

2. Multiple plans

The API does not support checking out more than one plan at a time. Ensure you are not passing item price IDs for multiple plans.

3. API syntax

Verify the request matches the syntax in the Hosted Page API docs. If the error persists, contact support.

Additional Information