Post Packs API

Post Packs are one-time credit bundles that extend your monthly post quota. Available to Starter plan and above.

Purchase a Pack

POST /packs/purchase

Parameter	Type	Required	Default	Description
`pack_type`	string	No	`"50"`	`"50"` ($12 for 50 posts) or `"200"` ($29 for 200 posts)

curl -X POST https://api.postlark.ai/v1/packs/purchase \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "pack_type": "50" }'

{
  "message": "Post Pack 50 purchase initiated. Complete payment via Paddle checkout.",
  "pack_type": "50",
  "price": "$12",
  "posts": 50
}

Check Balance

GET /packs/balance

Returns the total remaining pack credits and a breakdown of each active pack.

curl https://api.postlark.ai/v1/packs/balance \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx"

{
  "balance": 150,
  "packs": [
    {
      "balance": 50,
      "purchased_at": "2026-03-01T12:00:00Z"
    },
    {
      "balance": 100,
      "purchased_at": "2026-03-20T08:00:00Z"
    }
  ]
}

How Packs Work

Post Packs supplement your monthly subscription quota:

Monthly quota is consumed first — each billing cycle resets your plan’s included posts
Pack credits are used for overflow — when monthly quota runs out, posts are deducted from your oldest pack
Packs never expire — unused credits carry over indefinitely
FIFO order — the oldest pack is consumed first

Pack	Price	Posts	Per-post cost
Pack 50	$12	50	$0.24
Pack 200	$29	200	$0.145

Errors

Status	Cause
400	Invalid `pack_type` (must be `"50"` or `"200"`)
400	Blog not resolved
403	Free plan — upgrade required

See also: Rate Limits | Authentication | Blogs API