Social media API for AI agents that draft, schedule, and publish content
Let AI agents generate campaign ideas, create platform-specific post payloads, upload assets, and schedule social content through a controlled API workflow.
Last updated: May 2026
1const response = await fetch("https://api.bundle.social/api/v1/post", {2 method: "POST",3 headers: {4 "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,5 "Content-Type": "application/json"6 },7 body: JSON.stringify({8 teamId: "team_123",9 title: "Agent generated campaign",10 postDate: "2026-05-14T10:00:00.000Z",11 // Keep as draft for human review before publishing12 status: "DRAFT",13 socialAccountTypes: ["LINKEDIN", "TWITTER"],14 data: {15 LINKEDIN: { text: "Our AI agent drafted this insight on automation trends." },16 TWITTER: { text: "AI agents are changing how we publish." }17 }18 })19});Letting agents talk directly to native APIs
What bundle.social handles
Agents need a publishing boundary
The API gives AI workflows a concrete place to create posts, schedule campaigns, and inspect status while your team controls connected accounts.
Workflow
How it works
Connect accounts once, then create and schedule posts with channel-specific fields from one API.
Generate structured payloads
Your agent generates a JSON payload with the post content, media, and platform-specific data.
Create posts as Drafts
The agent submits the payload to the API with a DRAFT status for human review and approval.
Listen for webhooks
Use webhooks to notify your agent when a post is published, failed, or retried to trigger the next action.
Capabilities
API controls for agentic content workflows
Create, schedule, inspect, and report on posts generated by agents without exposing every platform credential.
Structured post payloads
Agents can produce explicit platform data blocks instead of unstructured instructions for a human operator. Enforce strict JSON schemas for generated content.
Scheduled execution
Generated content can be queued for future publication, giving teams time to review before it goes live. Set posts as DRAFT for human approval.
Status feedback loop
Agents can check whether posts are scheduled, posted, failed, or need a retry. Use webhooks to trigger the next agentic step automatically.
Media upload handoff
Upload creative assets once and let agents reference upload IDs in post payloads. Separate image generation from the final publishing step.
Developer example
Queue an agent-generated campaign post
Examples use bundle.social's public API shape: API key authentication, a post date, selected social account types, and platform-specific data.
1const response = await fetch("https://api.bundle.social/api/v1/post", {2 method: "POST",3 headers: {4 "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,5 "Content-Type": "application/json"6 },7 body: JSON.stringify({8 teamId: "team_123",9 title: "Agent generated campaign",10 postDate: "2026-05-14T10:00:00.000Z",11 // Keep as draft for human review before publishing12 status: "DRAFT",13 socialAccountTypes: ["LINKEDIN", "TWITTER"],14 data: {15 LINKEDIN: { text: "Our AI agent drafted this insight on automation trends." },16 TWITTER: { text: "AI agents are changing how we publish." }17 }18 })19});Supported content
Honest limitations
- AI-generated content should still pass your review and policy rules before publishing.
- Native platform rules still apply to automated content and account eligibility.
- Agents need your product logic to decide when a draft becomes an approved scheduled post.
Guarantees
Developer-first infrastructure
2% error rate
We handle the platform edge cases, media processing, and rate limits so your requests succeed.
Verbose errors
When native APIs fail, we return human-readable error messages and actionable recovery steps.
Flat pricing
No per-post counting. Predictable pricing for teams managing many users, workspaces, and connected accounts.
Same-day support
Direct access to the engineers building the API. We respond to technical issues the same day. Sometimes the same hour. Test us c;
Resources
Technical guides & documentation
How to Automate Social Media Posting with n8n
Learn how to build a free social media automation workflow using n8n.
How to Create an AI Brand Voice XML
Learn how to use a structured XML file to define your brand voice for AI tools.
API Reference: Webhooks
Trigger agent workflows based on post status changes.
FAQ
Questions developers ask before building
Can an AI agent publish directly?
Technically yes through your backend, but most teams should keep review and scheduling controls between generation and publication.
Can agents check post status?
Yes. Posts have lifecycle states that can be queried and used as feedback for automation workflows.
Does this support multi-platform campaigns?
Yes. Agents can create one post targeting multiple socialAccountTypes with platform-specific data.