Admin APITiers
Create a tier.
Creates a tier. The tier input serializer accepts public Admin API field
names such as active, welcome_page_url, trial_days,
monthly_price, and yearly_price, then maps them to the internal tier
service fields.
Authorization
GhostAdminJWT Authorization<token>
Send Authorization: Ghost <JWT>. This is a custom Ghost scheme, not
standard Bearer.
The JWT is signed with HS256 using the Admin API key secret after hex
decoding it to bytes. The JWT header must include kid set to the Admin
API key id. Ghost verifies the aud claim against the requested Admin or
Content API path and enforces a maximum token age of 5 minutes.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/tiers/" \ -H "Content-Type: application/json" \ -d '{ "tiers": [ { "name": "Supporter", "type": "paid", "active": true, "currency": "usd", "monthly_price": 500, "yearly_price": 5000 } ] }'{
"tiers": [
{
"id": "string",
"name": "string",
"description": "string",
"slug": "string",
"active": true,
"type": "free",
"welcome_page_url": "http://example.com",
"visibility": "public",
"benefits": [
"string"
],
"currency": "string",
"monthly_price": 0,
"yearly_price": 0,
"trial_days": 0,
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
]
}