Skip to main content

Create Plan (v1)

Create a new subscription plan.

Method & Path​

POST /v1/admin/plans

Description​

Creates a new subscription plan with specified features and pricing.

Authentication​

Required: Admin authentication with plans.manage permission.

Request Body​

{
  "name": "Pro Plan",
  "price": 99.99,
  "billingPeriod": "monthly",
  "features": []
}

Response 201 Created​

{
  "plan": {
    "id": "507f1f77bcf86cd799439011",
    "name": "Pro Plan",
    "price": 99.99,
    "billingPeriod": "monthly"
  }
}

Common Errors​

  • 401 Unauthorized: Missing or invalid admin authentication token
  • 403 Forbidden: Insufficient permissions
  • 400 Bad Request: Invalid request body
  • 500 Internal Server Error: Server error