403 plan_limit

Symptom

An action returns HTTP 403 with error_code plan_limit, feature_unavailable, or plan_required. For example:

{ "error_code": "plan_limit", "detail": "Pinterest account limit (2) reached for starter plan.", "current_count": 2 }

Cause

Your plan caps how many of something you can have, or gates a feature off entirely. Three kinds:

• plan_limit — a resource count cap (Pinterest accounts or active API keys).
• feature_unavailable — a gated feature (asset upload, bulk import) is off on your plan.
• plan_required — a feature that requires a specific plan tier (team access needs Agency or Enterprise).

Per-plan limits

Plan	Pinterest accounts	API keys	Asset upload	Bulk import	Team
Playground (Free)	1	1	No	No	No
Starter	2	2	Yes	Yes	No
Growth	5	5	Yes	Yes	No
Agency	15	15	Yes	Yes	Yes
Enterprise	50	Unlimited	Yes	Yes	Yes

Note: asset upload and bulk import are blocked on the Free (Playground) plan. Free must publish from public image_urls. Team roles are Agency and Enterprise only.

Fix

Depending on the error:

• plan_limit (accounts) — disconnect a Pinterest account you no longer use, or upgrade to a plan with a higher cap.
• plan_limit (API keys) — revoke an unused active key, or upgrade.
• feature_unavailable — upgrade to a plan that includes the feature. The response’s upgrade_url (/v1/billing/checkout) takes you there. For asset upload specifically, see My video upload failed.
• plan_required (team) — upgrade to Agency or Enterprise. The upgrade_url is /pricing.

If you run several PinBridge accounts to work around limits, consolidate under one account on the right plan instead. It is simpler to manage and usually cheaper.

Related

• 402 quota_exceeded — the monthly pin quota (a different limit).
• Error reference — all 403 errors.
• Troubleshooting — all articles.