Skip to main content
POST
/
plans
/
{plan-id}
cURL
curl --request POST \
  --url https://api.spotflow.co/api/v1/plans/{plan-id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "Standard Monthly Plan",
  "frequency": "DAILY",
  "internalReference": "PLAN-STD-001",
  "pricingOptions": [
    {
      "amount": 123,
      "currency": "NGN"
    }
  ]
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "title": "string",
  "frequency": "DAILY",
  "internalReference": "string",
  "amount": 123,
  "currency": "NGN",
  "status": "ACTIVE",
  "regions": [
    "<string>"
  ],
  "subscribers": 123,
  "subscriptions": 123,
  "createdAt": "2023-11-07T05:31:56Z",
  "trial": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "planId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "periodInDays": 123,
    "pricingList": [
      {
        "type": "FLAT",
        "amount": 123,
        "currency": "NGN"
      }
    ]
  },
  "pricingOptions": [
    {
      "amount": 123,
      "currency": "NGN"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
plan-id
string<uuid>
required

Unique identifier for the plan to create or update.

Body

application/json
​
title
string

Name or title of the plan

Example:

"Standard Monthly Plan"

​
frequency
enum<string>

Billing frequency for the plan

Available options:
DAILY,
WEEKLY,
MONTHLY,
QUARTERLY,
BIANNUAL,
ANNUAL
​
internalReference
string

Internal reference code for the plan

Example:

"PLAN-STD-001"

​
pricingOptions
object[]

Pricing options for the plan

Response

Subscription plan successfully created or updated.

Represents detailed information about a subscription plan including pricing, trial, and region availability.

​
id
string<uuid>
required

Unique identifier of the subscription plan (UUID).

​
title
string
required

The title or name of the subscription plan.

Example:

"string"

​
frequency
enum<string>
required

Billing frequency for the subscription plan.

Available options:
DAILY,
WEEKLY,
MONTHLY,
QUARTERLY,
BIANNUAL,
ANNUAL
​
amount
number
required

The cost amount for the subscription plan.

​
currency
string
required

The currency of the subscription plan (e.g., NGN, USD).

Example:

"NGN"

​
status
enum<string>
required

The current status of the subscription plan.

Available options:
ACTIVE,
INACTIVE,
ARCHIVED
​
createdAt
string<date-time>
required

Date and time when the plan was created.

​
internalReference
string

Internal reference code or identifier for the plan.

Example:

"string"

​
regions
string[]

List of regions where this plan is available.

​
subscribers
integer

Total number of active subscribers under this plan.

​
subscriptions
integer

Total number of subscriptions created for this plan.

​
trial
object

Details about the trial period associated with this plan.

​
pricingOptions
object[]

Different pricing options available for the plan.