For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL. To search these docs, send a GET request to https://paddle-docs-retrieval.kapa-paddle.workers.dev/?q=<question> with a URL-encoded question. No authentication needed.

Skip to content
Paddle Docs home

New items not valid in subscription update

One or more of the items you're adding to the subscription isn't valid.

Example response
{
"error": {
"type": "request_error",
"code": "subscription_new_items_not_valid",
"detail": "the new items are not valid for updating this subscription",
"documentation_url": "https://developer.paddle.com/errors/subscriptions/subscription_new_items_not_valid"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
subscription_new_items_not_valid
Error message
the new items are not valid for updating this subscription

Common causes

  • One or more of the items you're trying to add is invalid — for example, an inactive price, a mismatched billing cycle, or a quantity out of range.

Troubleshooting

  • Check the individual errors in the response to see which item failed and why, then fix and retry.

Was this page helpful?