Create Project Plan

Create a new subscription plan for a project.

POST/v2/projects/{project_id}/plans

Authorization

Bearer TokenRequired

Path Parameters

project_idstringRequired

The unique identifier of the project.

Request Body

plan_namestringRequired

Display name of the plan.

plan_pricestringRequired

Price amount for the plan as a string (e.g., '10', '29.99').

plan_currencystringRequired

Three-letter currency code (e.g., USD, EUR).

plan_durationstringRequired

Duration of the plan (e.g., '1 hour', '1 day', '1 month').

plan_price_formattedstringRequired

Formatted price display string (e.g., '$10.00').

plan_dataobject

Additional plan configuration options.

plan_data.plan_recurringboolean

Whether the plan supports recurring payments.

plan_data.plan_one_timeboolean

Whether the plan supports one-time payments.

Request

curl -X POST "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/plans" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_name": "Pro Plan",
    "plan_price": "29.99",
    "plan_currency": "USD",
    "plan_duration": "1 month",
    "plan_price_formatted": "$29.99"
  }'

const project_id = 'YOUR_PROJECT_ID';
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/plans`, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    plan_name: 'Pro Plan',
    plan_price: '29.99',
    plan_currency: 'USD',
    plan_duration: '1 month',
    plan_price_formatted: '$29.99'
  })
});
const data = await response.json();

import requests
 
project_id = 'YOUR_PROJECT_ID'
response = requests.post(
    f'https://api.botsubscription.com/v2/projects/{project_id}/plans',
    headers={'Authorization': 'Bearer YOUR_TOKEN'},
    json={
        'plan_name': 'Pro Plan',
        'plan_price': '29.99',
        'plan_currency': 'USD',
        'plan_duration': '1 month',
        'plan_price_formatted': '$29.99'
    }
)
data = response.json()

$project_id = 'YOUR_PROJECT_ID';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/plans");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'plan_name' => 'Pro Plan',
    'plan_price' => '29.99',
    'plan_currency' => 'USD',
    'plan_duration' => '1 month',
    'plan_price_formatted' => '$29.99'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Plan createdapplication/json

{
  "ok": true,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "POST",
  "path": "/v2/projects/YOUR_PROJECT_ID/plans",
  "code": 201,
  "message": "Plan created successfully",
  "data": {
    "plan_name": "Pro Plan",
    "plan_price": "29.99",
    "plan_currency": "USD",
    "plan_duration": "1 month",
    "plan_price_formatted": "$29.99",
    "plan_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
    "plan_data": {
      "plan_recurring": false,
      "plan_one_time": true
    },
    "plan_targets": []
  }
}

Last updated: January 15, 2026

API Endpoint

Create Project Plan

Authorization

Path Parameters

Request Body