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

# BAMF Developer Platform API

The BAMF API publishes social content and runs creator-marketing workflows across LinkedIn, X, and Instagram. It creates, schedules, and publishes posts, prepares and queues outreach campaigns, and runs asynchronous generation jobs for posts, images, carousels, and videos. Analytics endpoints report post and audience performance, and creator spaces organize members, brand kits, and knowledge for each client workspace.

## For AI agents

Create, schedule, and publish social posts to LinkedIn, X, and Instagram, run outreach campaigns, generate post and video content as jobs, and read analytics across creator workspaces.

## Scope

Does not handle paid ad spend, payment processing, or email newsletters. Use for creating, scheduling, and analyzing social posts across connected creator workspaces only.

## Capabilities

- Create, schedule, and publish posts to LinkedIn, X, and Instagram
- Prepare and queue outreach campaigns and track their status
- Generate post drafts, images, carousels, and videos as asynchronous jobs
- Read analytics summaries and per-network post performance
- Configure creator spaces, members, and brand kits for client workspaces
- Register webhooks to receive publishing and generation job events

## Use cases

### AI Agent Social Publishing

An AI agent drafts, schedules, and publishes social posts across LinkedIn, X, and Instagram without a developer wiring each network by hand. Through Jentic the agent imports BAMF, creates a draft post in a workspace, and schedules it, while the bearer token stays on the developer's own machine.

Example prompt: Create a draft post in a workspace, attach a generated image, and schedule it to publish at a set time

### Content Generation Pipeline

Creator teams turn briefs into finished assets at scale. BAMF runs asynchronous generation jobs for post copy, images, carousels, and videos, returning a job the agent polls until the asset is ready to attach to a post.

Example prompt: Start a carousel generation job from a brief, poll it until complete, and attach the result to a scheduled post

### Outreach Campaign Automation

Growth teams run creator outreach across platforms and need to track each campaign's state. BAMF lets an agent prepare an outreach campaign, queue it, and poll its status, then read analytics to judge which campaigns landed.

Example prompt: Prepare an outreach campaign, queue it, and poll its status until it reports complete

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/posts` | List posts |
| POST | `/posts` | Create a draft post |
| POST | `/posts/{post_id}/schedule` | Schedule a post |
| POST | `/posts/{post_id}/publish` | Publish a post immediately |
| POST | `/outreach/campaigns` | Prepare an outreach campaign |
| GET | `/analytics/summary` | Get an analytics summary |
| POST | `/generate/posts` | Create a post generation job |
| GET | `/workspaces/{workspace_id}/sites` | List hosted sites for a workspace |

## Key resources

- **Posts** — Create, schedule, publish, pause, and boost social posts
- **Generation** — Run asynchronous jobs for post copy, images, carousels, and videos
- **Outreach** — Prepare, approve, queue, and track outreach campaigns and discoveries
- **Analytics** — Read post, audience, and funnel analytics across LinkedIn and X
- **Creator Spaces** — Organize members, brand kits, knowledge, and settings per workspace
- **Webhooks** — Register endpoints to receive publishing and job events

## 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:** 39 / 100
- **Maturity:** Non-Ready
- **Dimensions:**
  - Foundational Compliance: 46 / 100
  - Developer Experience & Jentic Compatibility: 58 / 100
  - AI-Readiness & Agent Experience: 19 / 100
  - Agent Usability: 64 / 100
  - Security: 60 / 100
  - AI Discoverability: 65 / 100
- **View full report:** https://jentic.com/apis/bamf.ai/bamf/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 BAMF by hand means handling its bearer auth, connecting each social network, and polling long-running generation and outreach jobs yourself. Through Jentic you install once, import BAMF from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** BAMF puts the workspace id in the URL path (`/workspaces/{workspace_id}/...`), so a rule can pin your agent to one workspace and the operations you pick, such as creating and scheduling posts. You choose which operations it may call, so immediate publishing or member removal is not included unless you add it.
- **Credential handling:** Your BAMF 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 post' or 'generate a carousel', and Jentic returns the matching BAMF 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 networks with a simpler queue model.
- **Sprout Social** — Sprout Social manages publishing, engagement, and analytics for social teams.
- **LinkedIn Marketing** — LinkedIn Marketing manages native LinkedIn ad campaigns and company page content.

## FAQ

### Is there a BAMF MCP server?

You don't need an MCP server to give your agent the BAMF API. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent calls it. Operations are discovered on demand, so no extra tool definitions load into the agent's context.

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

Yes. Write a rule that allows only the post create and schedule operations under one workspace id, so the agent can draft and queue posts for that client but cannot publish immediately or remove members, and every call is logged.

### What authentication does the BAMF Developer Platform API use?

The BAMF API authenticates with a bearer token, as declared in its OpenAPI spec. Most endpoints require that token; several read-only endpoints, such as the public health check and shared analytics links, need no credential. Through Jentic the token is stored encrypted by your own Jentic One instance and injected at call time.

### Can I schedule and publish posts across networks with the BAMF API?

Yes. Create a draft post, schedule it for a future time, or publish it immediately, and the same post surfaces in the LinkedIn and X analytics endpoints so the agent can read how each network performed.

### How do I schedule a social post through Jentic?

Install Jentic One with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, then import the BAMF API from the Jentic API Directory and store your bearer token. Your agent searches for 'schedule a social post' and Jentic returns the schedule operation with its input schema. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### What are the rate limits for the BAMF Developer Platform API?

The BAMF OpenAPI spec does not define rate limits. Generation and outreach run as asynchronous jobs you poll, so throughput depends on job processing rather than a fixed per-second ceiling; check your BAMF plan for current limits.