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.

Skip to content
Paddle Docs home

Billing cycle required for trial period

Only recurring prices can include a trial period.

Example response
{
"error": {
"type": "request_error",
"code": "price_trial_period_requires_billing_cycle",
"detail": "Setting a `trial_period` requires `billing_cycle` to be set.",
"documentation_url": "https://developer.paddle.com/errors/prices/price_trial_period_requires_billing_cycle"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
price_trial_period_requires_billing_cycle
Error message
Setting a `trial_period` requires `billing_cycle` to be set.

Common causes

  • Only recurring prices can have a trial period. trial_period is included but billing_cycle isn't set.

Troubleshooting

  • Add a billing_cycle to your request.
  • Remove trial_period if you don't need a trial for this price.

Was this page helpful?