Home / Use cases / A social media posting API that keeps your approval rules

A social media posting API that keeps your approval rules

Most posting APIs are a thin pipe to one network. GPTpost's agent API sits in front of a whole workspace: one call creates a post for several connected accounts, and the post still goes through the per-network checks, approvals and plan limits your team set up in the app.

What GPTpost does

One API for many networks. Create a post once with a list of account ids and optional per-network text. It can go to Mastodon, Bluesky, Lemmy, X, DEV, WordPress, Telegram, Discord, Slack, Listmonk and Whop.
Scoped keys. Workspace owners and admins create keys in Settings, API and Agents. Scopes are accounts:read, posts:read, posts:write and media:write, with an optional expiry. A key is shown once and stored only as a hash.
The app's rules still apply. Text over a network's limit is refused with 422, a post that needs approval answers 409 and waits for review, and plan limits answer 402. An agent cannot skip what a person in the app could not skip.
Safe retries. Send an Idempotency-Key header on create calls so a retry never creates a duplicate post. Each key gets about 120 requests and 30 writes per minute, with a Retry-After header on 429.
OpenAPI and MCP. The schema at app.oraglegpt.org/openapi.json works with OpenAPI-aware tools, and the same operations are MCP tools at app.oraglegpt.org/mcp.
On every plan. API keys are included in Solo, Team and Agency and in the 14-day free trial.

Quick start

curl https://app.oraglegpt.org/api/v1/agent/accounts \
  -H "Authorization: Bearer $GPTPOST_API_KEY"

curl -X POST https://app.oraglegpt.org/api/v1/agent/posts \
  -H "Authorization: Bearer $GPTPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"text":"Hello from my script","account_ids":["ACCOUNT_ID"],"schedule_at":"2026-11-02T09:00:00Z"}'

Full reference, scopes, error codes and MCP setup: GPTpost Developers.

What it does not do yet

The API creates, schedules and publishes posts and reads their status. It does not read comments, messages or analytics from the networks, and it cannot connect social accounts, manage users or change billing: connecting an account happens once in the app. Networks still waiting for their app review (Facebook Pages, Instagram, Threads, TikTok, YouTube, LinkedIn, Pinterest, Google Business Profile) are not available through the API either.

X is available now. Facebook Pages, Instagram, Threads, TikTok, YouTube, LinkedIn, Pinterest and Google Business Profile are built into GPTpost and become available as each network completes its review of the app.

Questions

Does GPTpost have an API?

Yes. A REST API under app.oraglegpt.org/api/v1/agent/ with an OpenAPI 3.1 schema, plus a remote MCP server at app.oraglegpt.org/mcp. Both use workspace API keys sent as a Bearer token.

Which plans include the API?

All of them: Solo (USD 12), Team (USD 39) and Agency (USD 99) per workspace per month, and the 14-day free trial.

Can the API bypass approvals?

No. If the workspace requires approval, an API-created post waits for review and the API answers 409 approval_required.