canonical: https://jentic.com/apis/autoposting.ai/autoposting

# Autoposting API

The Autoposting API schedules, publishes, and AI-enhances social content across X, LinkedIn, Instagram, Threads, and YouTube. It drafts, schedules, publishes, rewrites, and scores posts, and generates carousels and short video clips from source material. Autonomous posting agents, brand workspaces, knowledge bases, and per-platform OAuth connections round out the surface, all behind a consistent success-and-data response envelope.

## For AI agents

Draft, schedule, publish, rewrite, and score social posts across X, LinkedIn, Instagram, Threads, and YouTube, and generate carousels and clips. Returns structured JSON over a REST API authenticated with an API key.

## Scope

Does not run paid ad campaigns, send email or SMS, or host video files for playback. Use for scheduling and publishing organic social content only.

## Capabilities

- Create, schedule, and publish posts to X, LinkedIn, Instagram, Threads, and YouTube
- Rewrite and score post content with AI before publishing
- Generate carousels and short video clips from source material
- Run autonomous posting agents on a schedule and review their outputs
- Organise brand workspaces and connect each platform's OAuth tokens for publishing

## Use cases

### AI Agent Social Publishing via Jentic

An agent that manages a social presence can call Autoposting through Jentic without wiring the API key or juggling per-platform OAuth. The agent searches by intent, receives the operation schema, and drafts, schedules, or publishes a post across platforms. This fits marketing agents and content pipelines that produce and distribute posts programmatically.

Example prompt: Search Jentic for 'schedule a social post', load the operation schema, draft the post, and queue it for the chosen platforms

### Cross-Platform Post Scheduling

Draft a post once and schedule it to publish across X, LinkedIn, Instagram, Threads, and YouTube. Autoposting stores the draft, holds it on a schedule, and publishes it to the platforms set on the post, so an agent can run a content calendar without a separate scheduler per network.

Example prompt: Call POST /posts to create a post, then PUT `/posts/{postId}/schedule` to queue it

### AI Content Generation

Produce carousels, short clips, and refined copy from source material. Autoposting generates carousel content and designs, cuts clips from longer video, and rewrites or scores draft copy, so a marketing agent can turn a brief or a recording into ready-to-post assets.

Example prompt: Call POST `/carousels/generate` to produce carousel content from a topic

### Autonomous Posting Agents

Create agents that produce and post content on a schedule, then review their runs and outputs. Autoposting lets an operator spin up an agent, trigger an immediate run, and inspect what it generated, so a team can automate a recurring posting cadence with a human reviewing results.

Example prompt: Call POST /agents to create an agent, then POST `/agents/{agentId}/run` to trigger a run

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/posts` | Create a new post |
| PUT | `/posts/{postId}/schedule` | Schedule a post |
| POST | `/posts/{postId}/publish` | Publish a post immediately |
| POST | `/posts/{postId}/rewrite` | AI rewrite post content |
| POST | `/carousels/generate` | AI-generate carousel content |
| POST | `/clips/{clipId}/publish` | Publish a clip to platforms |
| POST | `/agents` | Create an AI posting agent |
| GET | `/brands` | List brands |

## Key resources

- **Posts** — Draft, schedule, publish, rewrite, and score posts
- **Carousels** — Generate and design multi-slide carousel content
- **Clips** — Import video, cut clips, and publish them to platforms
- **Agents** — Autonomous posting agents, their runs, and outputs
- **Brands** — Brand workspaces and per-platform OAuth token connections

## 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:** 57 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 74 / 100
  - Developer Experience & Jentic Compatibility: 70 / 100
  - AI-Readiness & Agent Experience: 47 / 100
  - Agent Usability: 49 / 100
  - Security: 55 / 100
  - AI Discoverability: 65 / 100
- **View full report:** https://jentic.com/apis/autoposting.ai/autoposting/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 Autoposting API by hand means managing its API key (a Bearer token or the x-api-key header), connecting each platform's OAuth tokens per brand, and sequencing create, schedule, and publish calls yourself. Through Jentic you install once, import Autoposting from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Autoposting puts the brand slug and post id in the URL path (`/brands/{brandSlug}`, `/posts/{postId}`), so a rule can pin your agent to one brand and the post operations you choose. You choose the operations it may call, so you can allow drafting and scheduling while leaving immediate publish or delete out.
- **Credential handling:** Your Autoposting 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 'generate a carousel', and Jentic returns the matching Autoposting operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Sendible API** — Alternative multi-platform social scheduling and publishing
- **Mixpost** — Self-hostable social media scheduling and publishing
- **Late API** — Developer-first social scheduling API

## FAQ

### Is there an Autoposting MCP server?

You don't need a separate MCP server to give your agent the Autoposting API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the draft, schedule, publish, and generate operations it needs.

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

Yes. Write a rule that allows drafting and scheduling posts for one brand slug, so the agent can prepare and queue content for that brand while publishing immediately or deleting posts stays out of reach. Every call is logged by your self-hosted instance.

### What authentication does the Autoposting API use?

The Autoposting API authenticates with an API key sent as a Bearer token in the Authorization header or in the x-api-key header, per its OpenAPI spec. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time.

### Can I schedule posts across multiple platforms with the Autoposting API?

Yes. Create a post and schedule it, and the platforms it targets, such as X, LinkedIn, Instagram, Threads, and YouTube, are set on the post itself. The API also rewrites and scores content and generates carousels and clips.

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

The OpenAPI spec does not specify rate limits. Check the vendor's documentation at https://autoposting.ai for current limits and plan tiers.

### How do I schedule a social post with the Autoposting API through Jentic?

Search Jentic for 'schedule a social post' and it returns the Autoposting operations with their input schemas; the agent drafts the post and queues it for the chosen platforms. To run it on your own infrastructure, install Jentic One from its GitHub repo.
