REST API · Standard plan and above
A social media scheduling API you call with one header
Hookpost's social media scheduling API, the Public API, schedules, publishes and deletes posts on every channel you have connected. It is plain REST with JSON in and out, and one request can send a post to LinkedIn and X at the same time. It is included from Standard at ₹599 a month, which covers 5 channels and 500 posts.
Two requests to your first scheduled post
Copy your key from Settings → Developers. It goes in the Authorization header on its own, with no Bearer prefix. First, list your channels to get their ids:
curl "https://hookpost.hookstep.in/api/public/v1/integrations" \ -H "Authorization: YOUR_API_KEY"
Then create the post. type is schedule, now or draft, and dates are ISO 8601 in UTC. Each entry in posts is one channel, so this schedules different copy to LinkedIn and X in a single call:
curl -X POST "https://hookpost.hookstep.in/api/public/v1/posts" \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "schedule",
"date": "2026-10-01T09:00:00.000Z",
"shortLink": false,
"tags": [],
"posts": [
{
"integration": { "id": "LINKEDIN_CHANNEL_ID" },
"value": [{ "content": "We shipped the new dashboard today.", "image": [] }]
},
{
"integration": { "id": "X_CHANNEL_ID" },
"value": [{ "content": "New dashboard is live.", "image": [] }]
}
]
}'Hookpost validates each post against the network's rules before it is queued, the same checks the app runs. A post that is too long for X, or one missing a required channel setting, comes back as a 400 with the channel and the reason, not as a failure at publish time. Channels that need extra fields expose their schema at /integration-settings/:id.
What the API covers
- Posts
- Create (schedule, publish now or draft), list by date range, delete, update status and per-channel settings, check which channels a post has not gone out on.
- Scheduling
- GET /find-slot/:id returns the next free slot in your posting schedule for a channel.
- Channels
- List connected channels, read a channel’s settings schema, start connecting a new channel, disconnect one.
- Media
- Upload a file, or upload from a public URL. The response includes the path you attach to a post.
- Analytics
- Channel-level analytics and per-post analytics.
Webhooks. Add one under Settings → Webhooks and Hookpost POSTs the post as JSON to your URL after it publishes, optionally only for chosen channels. Standard includes 2; Pro includes 30.
Limits. Creating posts is capped per organisation over a one-hour window, and going over returns HTTP 429. Reads are not throttled. Every post also counts toward your monthly allowance: 500 on Standard, 2,000 on Pro. A key on an account with no paid plan returns 401 No subscription found.
Channels the API can publish to today
- X (Twitter)
- YouTube
- Facebook Pages
- Bluesky
- Discord
- Slack
- Telegram
- WordPress
- Hashnode
- Dev.to
- Lemmy
- Nostr
- Listmonk
Instagram and Threads are built but waiting on Meta app approval, so new accounts cannot connect them yet. Pinterest can be connected but cannot publish yet. Medium stopped issuing new API tokens, so only accounts with an older token can connect.
The same key works everywhere else
- Node.js SDK.
npm install @hookpost/node, a typed client for the same endpoints that works with both import and require. - CLI.
npx hookpost channelslists your channels;hookpost post "text" --channel IDschedules into your next free slot. SetHOOKPOST_API_KEYto use it in CI. - n8n. The n8n-nodes-hookpost community node wraps these endpoints for no-code workflows.
- MCP. The Hookpost MCP server lets Claude, Cursor and other MCP clients list channels and schedule posts. See the Claude setup guide.
- OAuth. Building something other people connect their own Hookpost account to? Use OAuth apps rather than collecting API keys.
Compared with Buffer's API and Ayrshare
Read off each company's own pages on 26 September 2026. Follow the source link to confirm.
| API | Style | Cheapest way in | Source |
|---|---|---|---|
| Hookpost | REST, JSON. Key sent as a bare Authorization header. | Standard, ₹599/month for 5 channels and 500 posts. No API on the Free plan. | our pricing |
| Buffer | GraphQL at api.buffer.com. Bearer API key or OAuth 2.0. | Available on Buffer’s Free plan: 1 API key, 100 requests per 15 minutes, 250 per day, 3,000 per 30 days. | their docs |
| Ayrshare | API built for platforms that post on behalf of many user profiles. | No free plan listed. Premium $149/month for 1 social profile; Launch $299/month for up to 10 profiles, with a 28-day trial. | their docs |
The honest summary: Buffer lets you try its API on a free plan, which Hookpost does not. Ayrshare is priced for platforms posting on behalf of many users. If you are automating your own or your company's channels, Hookpost gives you a REST API, webhooks, an MCP server and an n8n node for ₹599 a month. More detail in the Buffer comparison.
Questions
- Is there an API to schedule social media posts?
- Yes. Hookpost's Public API schedules, publishes and deletes posts over plain REST at https://hookpost.hookstep.in/api/public/v1. One request can target several channels at once. It is included from the Standard plan at ₹599 a month.
- Which networks can the API post to?
- X, LinkedIn, YouTube, Facebook Pages, Bluesky, Discord, Slack, Telegram, WordPress, Hashnode, Dev.to, Lemmy, Nostr and Listmonk, for any account connected today. Instagram and Threads are waiting on Meta app approval, Pinterest cannot publish yet, and Medium no longer issues new API tokens.
- What are the API rate limits?
- Creating posts is capped per organisation over a one-hour window, and going over returns HTTP 429. Reads are not throttled. Separately, every post counts toward your plan’s monthly post limit.
- Is Hookpost a Buffer API alternative?
- For some teams. Buffer’s API is GraphQL and is available on its free plan with daily and monthly request caps. Hookpost’s is REST, needs a paid plan, and adds an MCP server, a CLI and an n8n node on the same key. If you want a free tier to experiment with, Buffer is the cheaper place to start.
- Is Hookpost an Ayrshare alternative?
- If you are posting to your own or your company’s channels, yes: Standard is ₹599 a month against Ayrshare’s $149 a month entry plan. Ayrshare is built for SaaS platforms posting on behalf of many end users, which Hookpost’s plans are not priced for.
Full endpoint list and error messages: Public API reference. Plan limits: pricing.