REST API

Posts endpoints

List the posts in your workspace and create new drafts from your own code.

Oct 11, 20261 min read
MethodPathScopeDoes
GET/menoneReturns the workspace and the key's scopes
GET/postsreadLists the workspace's posts, page by page
POST/postswriteCreates a draft post

List posts

Pass page (from 1) and limit (default 20, max 100).

curl "https://api.aeroreply.com/public/v1/posts?page=1&limit=20" \
  -H "Authorization: Bearer ar_live_…"
{
  "data": [
    "…"
  ],
  "total": 42,
  "page": 1,
  "limit": 20,
  "pages": 3
}

Create a draft

  • name: optional, 1 to 120 characters, shown in your drafts list
  • caption: optional, up to 5,000 characters
curl -X POST https://api.aeroreply.com/public/v1/posts \
  -H "Authorization: Bearer ar_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Launch teaser","caption":"Something new lands Monday."}'

The response is 201 Created with { "post": { … } }. The draft appears in AeroReply, where your team can add media, adapt it per platform and schedule it.

Was this helpful?
Ship on-brand posts in minutes

AI content, scheduling, engagement and a full marketing suite — free to start.

Start free
Back to documentation

Keep reading

Put this into practice in AeroReply

Every tool lives in the same account, from the free plan up.

Put this into practice

Start free — design, schedule and grow from one workspace.

  • No credit card
  • 2-minute setup
  • Cancel anytime