REST API · Hookpost plan

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 in the Hookpost plan at $7 a month, which covers 20 channels and 2,000 posts a month.

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. The Hookpost plan 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: 2,000 on the Hookpost plan. A key on an account with no paid plan returns 401 No subscription found.

Channels the API can publish to today

Instagram needs a Business or Creator account. TikTok posts publish to your TikTok account with the audience it allows (Everyone, Friends, Followers or Only me), or go to your TikTok inbox as drafts if you choose that mode. Medium stopped issuing new API tokens, so Hookpost does not connect Medium.

From the terminal: CLI and Node SDK

Both are on npm and use the same key. The hookpost CLI (version 0.1.1) posts to one or more channels per command (--channel abc123,def456); leave out --at and the post takes the next free slot in your posting schedule. In CI, set HOOKPOST_API_KEY instead of running hookpost auth login.

npm install -g hookpost
export HOOKPOST_API_KEY="your_key"

hookpost channels
hookpost post "Release 2.3 is live." --channel abc123 --at 2026-10-20T03:30:00Z
hookpost post "Rough idea for Friday" --channel abc123 --draft
hookpost post "Ship log #12" --channel abc123,def456   # several channels, one post
hookpost slot abc123          # next free slot in your posting schedule
hookpost delete <postId>

@hookpost/node (version 1.0.2) wraps posting, listing, image upload, channels and delete, and works with import or require:

import Hookpost from '@hookpost/node';

const hookpost = new Hookpost(process.env.HOOKPOST_API_KEY!);
const channels = await hookpost.integrations();

await hookpost.post({
  type: 'draft',
  date: '2026-10-20T03:30:00.000Z',
  shortLink: false,
  tags: [],
  posts: [{ integration: { id: channels[0].id }, value: [{ content: 'Release 2.3 is live.', image: [] }] }],
});

Driving it from an AI assistant instead? The MCP server uses the same key; see posting from Claude Code. No-code workflows: the n8n node. Building something other people connect their own Hookpost account to? Use OAuth apps rather than collecting API keys.

From Zapier or Make (no native app)

Hookpost has no app in the Zapier or Make directories. Both can still call the API with a plain HTTP request, which is all the API needs.

Zapier: Webhooks by Zapier → Custom Request

  • Method: POST
  • URL: https://hookpost.hookstep.in/api/public/v1/posts
  • Headers: Authorization = your API key; Content-Type = application/json
  • Data: the JSON below, with fields mapped from your trigger

Make: HTTP → Make a request

  • URL: https://hookpost.hookstep.in/api/public/v1/posts, method POST
  • Headers: Authorization = your API key
  • Body type: Raw, content type JSON (application/json)
  • Request content: the JSON below
{
  "type": "schedule",
  "date": "{{ISO date from your trigger, e.g. 2026-10-20T03:30:00.000Z}}",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "LINKEDIN_CHANNEL_ID" },
      "value": [{ "content": "{{Post text from your trigger}}", "image": [] }]
    }
  ]
}

The date must be ISO 8601 in UTC (10:00 IST is 04:30Z), so put a date formatter step before the request if your trigger gives a local time. Get channel ids once with GET /integrations and paste them in. Change type to draft while you test the zap or scenario.

Scheduling many posts at once

Hookpost has no CSV import. To schedule a batch, loop over your file and make one request per post, or one request per date with several channels in it. A shell loop with the CLI:

# posts.tsv: date<TAB>text, one post per line
while IFS=$'	' read -r when text; do
  hookpost post "$text" --channel abc123 --at "$when" || echo "failed: $when"
done < posts.tsv

Post creation is rate-limited per workspace per hour, and over the limit the API answers 429, so pace long batches. An AI assistant connected over MCP can do the same from a pasted list: ask it to save each line as a draft on its date.

When something fails

Rejected before it is queued: 400
Too long for a network, missing media or a required setting. The response names the channel and the reason. Drafts skip these checks until you schedule them.
Retries can duplicate: no idempotency key
A successful create returns the new post ids. If a request times out, call GET /posts for that date range before sending it again.
Failed at publish time: state ERROR
GET /posts returns each post's state (QUEUE, DRAFT, PUBLISHED or ERROR) and, once live, its URL. The team also gets an in-app notification and, unless turned off, an email.
Account limits: 401, 402, 429
401 for a missing or wrong key or a workspace with no paid plan, 402 once the month's post allowance is used, 429 when post creation goes over the hourly limit.

Compared with Buffer's API and Ayrshare

Read off each company's own pages on 26 September 2026. Follow the source link to confirm.

Social media scheduling APIs compared
APIStyleCheapest way inSource
HookpostREST, JSON. Key sent as a bare Authorization header.Hookpost, $7/month for 20 channels and 2000 posts.our pricing
BufferGraphQL 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
AyrshareAPI 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 $7 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 in the Hookpost plan at $7 a month.
Which networks can the API post to?
Any channel connected in Hookpost: 18 networks, including X, LinkedIn, YouTube, Facebook Pages, Instagram (Business or Creator), Threads, Pinterest, Bluesky, Telegram, Discord, WordPress and Dev.to. TikTok posts publish to your TikTok account with the audience your account allows (Everyone, Friends, Followers or Only me), or go to your TikTok inbox as drafts if you choose that mode. Medium no longer issues new API tokens, so Hookpost does not connect it.
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.
Can I schedule posts from Zapier or Make?
Yes, with a plain HTTP request. There is no native Hookpost app in Zapier or Make, so use Webhooks by Zapier (Custom Request) or Make’s HTTP “Make a request” module to POST to /api/public/v1/posts with your key in the Authorization header.
What happens if a request fails or times out?
A post that breaks a network rule is rejected with a 400 that names the channel, before anything is queued. There is no idempotency key, so if a create request times out, list posts for that date range before retrying or you may schedule it twice. A post that fails later at publish time shows state ERROR in GET /posts.
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: Hookpost is $7 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.