PayPal · Schema
Create Plan Request
The create plan request details.
BillingCommerceDisputesInvoicesOrderPaymentsPayoutsSubscriptionTokensWebhook
Properties
| Name | Type | Description |
|---|---|---|
| product_id | string | The ID of the product created through Catalog Products API. |
| name | string | The plan name. |
| status | string | The initial state of the plan. Allowed input values are CREATED and ACTIVE. |
| description | string | The detailed description of the plan. |
| billing_cycles | array | An array of billing cycles for trial billing and regular billing. A plan can have at most two trial cycles and only one regular cycle. |
| payment_preferences | object | |
| taxes | object | |
| quantity_supported | boolean | Indicates whether you can subscribe to this plan by providing a quantity for the goods or service. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/plan_request_POST",
"title": "Create Plan Request",
"description": "The create plan request details.",
"type": "object",
"properties": {
"product_id": {
"type": "string",
"description": "The ID of the product created through Catalog Products API.",
"minLength": 6,
"maxLength": 50
},
"name": {
"type": "string",
"description": "The plan name.",
"minLength": 1,
"maxLength": 127
},
"status": {
"type": "string",
"description": "The initial state of the plan. Allowed input values are CREATED and ACTIVE.",
"minLength": 1,
"maxLength": 24,
"pattern": "^[A-Z_]+$",
"default": "ACTIVE",
"enum": [
"CREATED",
"INACTIVE",
"ACTIVE"
]
},
"description": {
"type": "string",
"description": "The detailed description of the plan.",
"minLength": 1,
"maxLength": 127
},
"billing_cycles": {
"type": "array",
"description": "An array of billing cycles for trial billing and regular billing. A plan can have at most two trial cycles and only one regular cycle.",
"minItems": 1,
"maxItems": 12,
"items": {
"$ref": "#/components/schemas/billing_cycle"
}
},
"payment_preferences": {
"$ref": "#/components/schemas/payment_preferences"
},
"taxes": {
"$ref": "#/components/schemas/taxes"
},
"quantity_supported": {
"type": "boolean",
"description": "Indicates whether you can subscribe to this plan by providing a quantity for the goods or service.",
"default": false
}
},
"required": [
"name",
"billing_cycles",
"payment_preferences",
"product_id"
]
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/paypal-plan-request-post"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.