canonical: https://jentic.com/apis/adaptlypost.com/adaptlypost

# AdaptlyPost Public API

The AdaptlyPost API creates, schedules, and publishes social media posts across Facebook, Instagram, Threads, TikTok, X, Bluesky, Mastodon, LinkedIn, Pinterest, YouTube, and Google Business Profile from one contract. A post can go out immediately, on a schedule, or as a draft, can be bulk-scheduled up to 100 at a time, and failed platforms can be retried while per-platform results are read back. Signed webhooks deliver events like post.published and account.unauthorized, and the analytics endpoints report views, likes, comments, shares, followers, and engagement rate per workspace, platform, day, and post, each compared against the previous window. It also generates and refines captions and starts AI image generations for a post.

## For AI agents

Create, schedule, and publish posts across Facebook, Instagram, TikTok, X, LinkedIn, YouTube and more, retry failed platforms, and read per-post analytics. Authenticates with a bearer token.

## Scope

Does not handle ad buying, direct messaging, or social inbox management. Use for scheduling, publishing, and measuring social posts only.

## Capabilities

- Create posts for Facebook, Instagram, TikTok, X, LinkedIn, YouTube and more as immediate, scheduled, or draft
- Bulk schedule up to 100 posts in one call and pause or resume recurring posts
- Publish, unschedule, or retry the failed platforms of a post and read its per-platform results
- Register signed webhooks for events such as post.published, post.failed, and account.unauthorized
- Read analytics overviews, timeseries, platform breakdowns, and top posts per workspace
- Generate and refine captions and start AI image generations for a post

## Use cases

### Agent-Scheduled Social Publishing via Jentic

An AI agent that drafts content can publish it on a schedule through AdaptlyPost instead of logging into each network. Through Jentic the agent generates a caption, creates a scheduled post targeting several platforms, and reads the per-platform results once it publishes, retrying only the platforms that failed.

Example prompt: Generate a caption, create a scheduled post for Instagram, X, and LinkedIn, then read its results after publishing and retry any platform that failed

### Cross-Platform Campaign Scheduling

Teams running a campaign queue many posts across networks at once. AdaptlyPost bulk-schedules up to 100 posts in a single call, supports recurring posts that can be paused and resumed, and lets a draft be published or unscheduled later, so a whole week of content is staged and adjusted programmatically.

Example prompt: Bulk schedule a set of posts for the coming week, then pause one recurring post and resume it to confirm the schedule control works

### Social Performance Reporting

AdaptlyPost reports performance per workspace, platform, day, and post, each with a comparison against the previous window of the same length. An agent reads the overview and top posts, breaks results down by platform, and requests a fresh analytics sync when it needs current numbers rather than the last scheduled refresh.

Example prompt: Read the workspace analytics overview for the last 30 days, break it down by platform, and list the top posts by engagement rate

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/social-posts` | Create a post (immediate, scheduled, or draft) |
| GET | `/social-posts` | List posts |
| POST | `/social-posts/bulk` | Bulk schedule up to 100 posts |
| POST | `/social-posts/{id}/publish` | Publish or schedule a draft post |
| GET | `/analytics/overview` | Workspace-wide totals for a date window |
| GET | `/social-accounts` | List connected social accounts |
| POST | `/webhooks` | Register a webhook endpoint |

## Key resources

- **Social posts** — Create, list, update, publish, unschedule, retry, and read results for posts, including bulk scheduling.
- **Social accounts** — List connected accounts, re-check an account, and create white-label connect links.
- **Webhooks** — Register, list, update, delete, and test signed webhook endpoints for post and account events.
- **Analytics** — Read overviews, timeseries, platform breakdowns, per-post metrics, and top posts, and request a sync.

## 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:** 67 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 99 / 100
  - Developer Experience & Jentic Compatibility: 63 / 100
  - AI-Readiness & Agent Experience: 47 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 75 / 100
- **View full report:** https://jentic.com/apis/adaptlypost.com/adaptlypost/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 AdaptlyPost by hand means learning its bearer auth, connecting each social account, verifying webhook signatures from the x-adaptly-signature header, and pacing yourself against its RFC 9331 rate-limit fields. Through Jentic you install once, import AdaptlyPost from the API Directory, store the token once, and your agent schedules and publishes posts.
- **Permission scoping:** AdaptlyPost puts the post id in the URL path (`/social-posts/{id}`), so a rule can limit your agent to acting on specific posts and to the operations you choose, such as creating and publishing. You decide which operations it may call, so deleting posts or revoking connect links stays out unless you add it.
- **Credential handling:** Your AdaptlyPost token 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 media post' or 'read post analytics', and Jentic returns the matching AdaptlyPost operation with its input schema so the agent calls the right endpoint directly.

## Related APIs

- **Buffer** — Buffer schedules and publishes social posts across networks; AdaptlyPost adds bulk scheduling, retries, and built-in caption and image generation.
- **Sprout Social** — Sprout Social is a broad social management suite; AdaptlyPost is a focused posting and analytics API.
- **Replicate** — Replicate runs image and video models; AdaptlyPost publishes the generated media on a schedule.

## FAQ

### What authentication does the AdaptlyPost API use?

The AdaptlyPost API authenticates with a key sent as a bearer token in the Authorization header, per its OpenAPI spec. The same key identifies the workspaces the caller can act in, which you can read from the describe-key endpoint. Through Jentic the token is stored encrypted on your own instance and injected at call time.

### Is there an AdaptlyPost MCP server?

You don't need an MCP server to give your agent AdaptlyPost. Jentic connects it directly from the API Directory: import AdaptlyPost, store your token once, and your agent schedules, publishes, and measures posts straight away. Operations are discovered on demand, so no extra server's tool definitions sit in your agent's context.

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

Yes. Because the post id travels in the URL path, you can write a rule that allows only creating and publishing posts, so the agent can schedule content and nothing else. Deleting posts, revoking connect links, or managing webhooks stays out of the rule unless you add it, and every call the agent makes is logged.

### Can I schedule a post to several platforms at once with the AdaptlyPost API?

Yes. A single create-post call targets multiple networks such as Instagram, X, LinkedIn, and TikTok, and can be immediate, scheduled, or a draft. You can bulk schedule up to 100 posts in one request, read per-platform publishing results, and retry only the platforms that failed.

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

The AdaptlyPost OpenAPI spec does not publish fixed numeric rate limits. Instead every response carries RFC 9331 rate-limit fields so a client can pace itself from the headers it receives. Check the AdaptlyPost documentation at https://adaptlypost.com for current limits.

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

Search the Jentic API Directory for an intent like 'schedule a social media post', import AdaptlyPost, and store your token once. Your agent then creates a scheduled post across the platforms you choose and reads its results through Jentic. To run it on your own infrastructure, install Jentic One from its GitHub repo.