Guide
Billing and usage
Plans, the connected-account allowance, usage, X API pass-through credits, invoices and billing webhooks.
Updated Oct 14, 2026
Billing is mostly managed in the app (Manage → Billing). The API exposes everything you need to read state and react to it, in the Billing reference (MCP toolset billing). Reads need the owner, admin or billing role, or any API key with read. Checkout, plan changes, payment methods and the customer portal are dashboard-only.
Plans
| Plan | Price | Accounts included | Extra account | API requests per hour |
|---|---|---|---|---|
| Free | $0 | 3 | – | 600 |
| Pro | $25/mo ($20/mo yearly) | 25 | $2/mo | 6,000 |
| Business | $250/mo ($200/mo yearly) | 250 | $1/mo | 30,000 |
| Enterprise | Custom | Unlimited | Custom | 120,000+ |
Posts are unlimited on every plan. Features such as broadcasts, automations, ads and hosted connect are plan-gated. GET /v1/billing/plans returns every plan with its features and limits.
Allowance and usage
curl https://api.socialit.com/v1/usage -H "Authorization: Bearer $SOCIALIT_API_KEY"GET /v1/usage returns connected accounts against the allowance, the current API request window, media storage and other metered limits. The account allowance is the plan’s included accounts plus purchased extra accounts (plus lifetime seats on legacy deals).
When a workspace ends up over its allowance (after a downgrade or cancellation), accounts stay connected but publishing pauses on the newest accounts beyond it, and billing.accounts_over_limit fires. GET /v1/billing returns publishing_paused and a banner you can show.
Plan errors
| Error | When |
|---|---|
403 plan_limit_error / plan_required |
The operation needs a feature your plan doesn’t have (required_plan says which) |
403 plan_limit_error / account_limit_reached |
Connecting would exceed the allowance (usage: { used, limit, requested }) |
402 plan_limit_error / insufficient_credits |
X API calls without prepaid credits |
403 plan_limit_error / analytics_history_limit |
Analytics older than your plan’s history window |
X API credits
X charges per API call. Socialit passes that cost through from prepaid credits: GET /v1/billing/x-pricing shows the price table, GET /v1/billing/credits the balance and packs, and GET /v1/usage/x-api the usage per day, account and endpoint. Postings record credits_charged.
Invoices and previews
GET /v1/billing/invoices (filter by status) and …/{id} return invoices. GET /v1/billing/preview?plan=business&interval=year&extra_accounts=10 previews a plan change with proration before you make it in the app.
Webhooks
billing.subscription_created, billing.subscription_updated, billing.subscription_canceled, billing.invoice_paid, billing.payment_failed, billing.credits_purchased and billing.accounts_over_limit. See Billing events.