error fields in response bodies — especially for multi-platform operations and connection checks.
NOT_CONNECTED
Platform account is not linked to the workspace.| Platform | Message pattern |
|---|---|
| LinkedIn not connected for this workspace. | |
| Facebook not connected for this workspace. | |
| Instagram not connected for this workspace. | |
| tiktok | TikTok not connected for this workspace. |
| youtube | YouTube not connected for this workspace. |
| Pinterest not connected for this workspace. | |
| threads | Threads not connected for this workspace. |
| bluesky | Bluesky not connected for this workspace. |
GET /unified/posts— empty slice for disconnected platformGET /unified/analytics— platform omitted from totals- Multi-platform post
results[]—success: false
handle + app_password — see Bluesky.
Plan blocked (plan_required)
Feature or credit not available on the workspace owner’s plan.
Common feature gates
| Feature key | Blocks |
|---|---|
api_keys_enabled | API key authentication |
mcp_enabled | Unified MCP access |
gpt_app_enabled | GPT Actions |
drafts_enabled | Draft create/list/publish |
scheduling_enabled | Schedule posts |
analytics_enabled | Unified analytics |
ai_composer_enabled | AI content/image generation |
auto_replier_enabled | AI comment replies |
403 Forbidden
Credit exhaustion uses 402 Payment Required:
Invalid API key
| Code | Message | HTTP |
|---|---|---|
APIKEY_INVALID | Invalid API key. | 401 |
APIKEY_NOT_FOUND | API key not found. | 401 |
APIKEY_REVOKED | API key has been revoked. | 401 |
APIKEY_EXPIRED | API key has expired. | 401 |
APIKEY_RATE_LIMIT | API key rate limit exceeded. | 429 / 403 |
- Confirm key starts with
psk_live_ - Copy full key from Settings (shown once at creation)
- Revoke compromised keys and create new ones
Scope mismatch
API keyscope restricts which platforms can be accessed.
403 Forbidden
Scope examples
| Scope | Can connect/post |
|---|---|
linkedin_only | LinkedIn only (default) |
linkedin_posts | Read-only: GET /unified/posts |
linkedin,instagram | LinkedIn + Instagram |
full | All supported platforms |
Platform-specific errors
| Error | Platform | Cause |
|---|---|---|
board_id_required | Missing pinterest.board_id | |
bluesky_text_error | Bluesky | Post creation failed |
| YouTube title message | YouTube | No title provided |
results[] with success: false.
Handling in code
Related
HTTP errors
Status codes
Authentication
Scopes and plan table
Errors overview
Two-layer model