Skip to content
Docs

Guide

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

Terminal
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.