beehiiv Developer Documentation

curl -X POST https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/tiers \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Gold Tier",
  "description": "Our premium tier with exclusive benefits",
  "prices_attributes": [
    {
      "currency": "usd",
      "amount_cents": 500,
      "interval": "month",
      "enabled": true,
      "interval_display": "Monthly",
      "cta": "Subscribe Now",
      "features": [
        "Exclusive content",
        "Ad-free experience",
        "Priority support"
      ]
    }
  ]
}'

{
  "data": {
    "id": "tier_00000000-0000-0000-0000-000000000000",
    "name": "Gold",
    "status": "active",
    "description": "description",
    "stats": {
      "active_subscriptions": 1
    },
    "prices": [
      {
        "id": "price_00000000-0000-0000-0000-000000000000",
        "amount_cents": 500
      }
    ]
  }
}

Create a new tier for a publication.

Authentication

AuthorizationBearer

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

Path parameters

publicationIdstringRequiredformat: "^(pub_[0-9a-fA-F\-]+)$"

The prefixed ID of the publication object

Request

This endpoint expects an object.

namestringRequired

descriptionstringOptional

prices_attributeslist of objectsOptional

Response

Created

dataobject

The subscription tier object.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error