canonical: https://jentic.com/apis/contentstudio.io/contentstudio

# ContentStudio API v1

The ContentStudio API schedules and publishes posts to connected social accounts, including Facebook, Bluesky, and Google Business Profile, then tracks how each post performs. It exposes per-network analytics such as summary KPIs, audience growth, and top posts, plus a unified inbox for replying to comments and direct messages. Content teams can group work into campaigns and labels, recycle posts with evergreen and RSS automations, and generate images or video for posts inside a workspace. Every operation is scoped to a workspace through the workspace_id path parameter.

## For AI agents

Schedule and publish social posts across connected accounts, pull per-network analytics, and reply to comments and direct messages from a unified inbox. Operations are grouped under a workspace.

## Scope

Does not handle ad campaign buying, link shortening, or website hosting. Use for social media publishing, analytics, and inbox management only.

## Capabilities

- Schedule and publish posts to connected Facebook, Bluesky, and Google Business Profile accounts
- Pull per-network analytics such as Facebook summary KPIs, audience growth, and top posts
- Reply to comments and direct messages from a unified social inbox
- Run evergreen and RSS automations that recycle and auto-post content
- Organize publishing with campaigns, labels, and content-category posting slots
- Generate AI images and video for posts within a workspace

## Use cases

### Agent-run social publishing

An AI agent connected through Jentic can draft a post, create it with createPost, and schedule it to several connected accounts in one workspace without a human opening the ContentStudio dashboard. The agent reads back post status with fetchPosts and can pause publishing for the workspace if drafts need review.

Example prompt: Create a post for the connected Facebook and Bluesky accounts scheduled for 09:00 tomorrow, then fetch the post to confirm its scheduled status

### Cross-network performance reporting

Marketing teams pull summary KPIs, audience growth, and top posts for each connected network to build a weekly report. ContentStudio exposes Facebook, Bluesky, and Google Business Profile analytics as separate endpoints so an agent can assemble a per-network rollup for the current period versus the previous one.

Example prompt: Pull the Facebook summary KPIs and audience-growth trend for the workspace and summarize the change versus the previous period

### Unified inbox response

Community managers triage comments, direct messages, and reviews from one inbox instead of switching between native apps. An agent can list inbox elements, send a reply to a comment or direct message, hide spam comments, and reply to reviews, all within a single workspace.

Example prompt: Find the newest unanswered comment in the inbox and post a reply, then mark the conversation as done

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/api/v1/workspaces/{workspace_id}/accounts` | List connected social accounts in a workspace |
| POST | `/api/v1/workspaces/{workspace_id}/posts` | Create a social media post |
| GET | `/api/v1/workspaces/{workspace_id}/posts` | Fetch scheduled and published posts |
| POST | `/api/v1/workspaces/{workspace_id}/campaigns` | Create a campaign |
| GET | `/api/v1/workspaces/{workspace_id}/analytics/facebook/summary` | Read Facebook summary KPIs for the current period |
| POST | `/api/v1/workspaces/{workspace_id}/inbox/conversations/{conversation_id}/messages` | Send a direct message from the inbox |

## Key resources

- **Posts** — Create, fetch, update, and delete scheduled and published posts, and pause or resume publishing for a workspace
- **Accounts** — List connected social accounts and connect or remove Facebook, Bluesky, and other networks
- **Analytics** — Read per-network summary KPIs, audience growth, engagement, and top posts
- **Inbox** — List conversations and send replies to comments, direct messages, and reviews
- **Automations** — Create evergreen and RSS automations and content-category posting slots

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 51 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 46 / 100
  - Developer Experience & Jentic Compatibility: 77 / 100
  - AI-Readiness & Agent Experience: 47 / 100
  - Agent Usability: 43 / 100
  - Security: 50 / 100
  - AI Discoverability: 69 / 100
- **View full report:** https://jentic.com/apis/contentstudio.io/contentstudio/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the ContentStudio API by hand means minting an X-API-Key, learning the workspace-scoped path layout, and threading the workspace id through every call. Through Jentic you install once, import ContentStudio from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** ContentStudio puts the workspace id in the URL path (`/api/v1/workspaces/{workspace_id}/...`), so a rule can pin your agent to one workspace. You choose the operations it may call, so destructive ones like removing a connected account or deleting a campaign are not included unless you add them.
- **Credential handling:** Your ContentStudio API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'schedule a social post' or 'pull Facebook analytics', and Jentic returns the matching ContentStudio operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Buffer** — Buffer schedules and publishes posts across social accounts with a simpler surface than ContentStudio's analytics and inbox.
- **Sprout Social** — Sprout Social covers publishing, analytics, and engagement for larger social teams.
- **Plausible Analytics** — Plausible measures the website traffic that published social posts drive.

## FAQ

### What authentication does the ContentStudio API use?

The ContentStudio API authenticates with an API key sent in the X-API-Key header, per its OpenAPI spec. Through Jentic the key is stored once by your own self-hosted instance and injected when a call runs, so it never appears in the agent's prompt or logs.

### Can I schedule posts to multiple networks with the ContentStudio API?

Yes. Create a post with the createPost operation under a workspace and target the connected accounts you want, such as Facebook, Bluesky, and Google Business Profile. You can fetch posts to confirm their scheduled status and pause publishing for the whole workspace while drafts are reviewed.

### Can I limit what my agent is allowed to do with the ContentStudio API?

Yes. Write a rule that pins the agent to one workspace id in the URL path and allows only the operations you pick, for example creating posts and reading analytics, so it cannot remove connected accounts or delete campaigns, and every call it makes is logged.

### What are the rate limits for the ContentStudio API?

The OpenAPI spec does not specify rate limits. Check the ContentStudio developer documentation at https://docs.contentstudio.io for current limits before running high-volume publishing jobs.

### Is there a ContentStudio MCP server?

You don't need an MCP server to give your agent the ContentStudio API. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent calls operations like createPost and fetchPosts on demand without loading another server's tool definitions into its context.

### How do I publish a post with the ContentStudio API through Jentic?

Search Jentic by intent such as 'schedule a social media post', and Jentic returns the createPost operation with its input schema so your agent fills in the workspace, accounts, and content. To run it on your own infrastructure, install Jentic One from its GitHub repo.