REST API

Workspace-scoped HTTP API with OAuth 2.0 client credentials. Mint short-lived bearer tokens and call JSON endpoints for posts, accounts, media, insights, and workflows.

Start free View pricing

What you can build

OAuth 2.0 client credentials flow
Scoped access tokens (posts, accounts, media, insights, workflows)
Schedule posts, publish now, and duplicate published content
List connected social accounts and media library files
Workspace insights summary and outbound webhooks

Base URL & authentication

API base: https://socialplod.com/api/v1

Token endpoint: https://socialplod.com/api/v1/oauth/token

Use HTTP Basic auth or form body with grant_type=client_credentials. Send Authorization: Bearer <token> on all API requests.

Key endpoints

POST /api/v1/oauth/token — Mint access token (client credentials)
GET /api/v1/posts — List posts
POST /api/v1/posts/schedule — Schedule a new post
POST /api/v1/posts/publish-now — Publish immediately
GET /api/v1/accounts — List connected accounts
GET /api/v1/insights/summary — Workspace insights summary
GET /api/v1/media — List media library files
POST /api/v1/workflows/{id}/run — Run a workflow manually

Also see the MCP server for AI assistant integrations using the same bearer tokens.

Frequently asked questions

Which plans include API access?

API and MCP access require a plan with the API & MCP access feature enabled. See pricing for plan details.

Where is the full API reference?

After signing in on an eligible plan, open the in-app API docs from your workspace API hub for endpoint examples and authentication details.