Reels and recurring schedules via API & MCP

Everything you can do in the Posto calendar for Reels videos and recurring schedules also works from n8n, Zapier, your agency systems, or an AI assistant. None of it uses AI credits, except AI caption variation on recurring schedules when turned on. How to create an API key and connect an AI assistant is in API and MCP.

Who can use it?

• You need API & MCP access (the Agency plan, or the API & MCP add-on).
• Reels videos are for the Pro, Ultimate, and Agency plans only, with a daily limit of new videos that depends on the plan. See Turn a carousel into a Reels video.
• Recurring schedules are for paid plans, with a number of active series per plan. See Recurring schedules.
• The API key needs the Schedule permission for schedules and series, and Create content to make videos.

Schedule as Reels

1. Call POST /api/v1/schedules as usual and add "format": "reels".
2. Optional: set the video with "video", for example {"secondsPerSlide": 3, "transition": "fade"}. Leave it out for the defaults.
3. Track it with GET /api/v1/schedules/{id}. Each account has a reelsStep: video (making the video), upload, processing (processed by the platform), then published.

Want to change the time, caption, or format before it goes live? Use PATCH /api/v1/schedules/{id}. Target accounts can't be changed; cancel and create a new schedule instead.

Create a recurring schedule

1. Call POST /api/v1/schedule-series with the carousel, platforms, rule (rule), and start date (startsOn).
2. Rule: freq daily, weekly (set byWeekday, 0 = Sunday to 6 = Saturday), or monthly (set byMonthDay, 1–28 or -1 for the last day), a time in the brand's time zone, and an optional end: until (date) or count (number of posts).
3. Posts for the next 14 days appear on the calendar right away (GET /api/v1/schedules, with seriesId). The rest are scheduled automatically.

curl -X POST https://posto.id/api/v1/schedule-series \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Idempotency-Key: seri-promo-gajian" \
  -H "Content-Type: application/json" \
  -d '{"carouselId":"<id carousel>","platforms":["instagram"],"rule":{"freq":"weekly","interval":1,"byWeekday":[1,4],"time":"19:00","count":8},"startsOn":"2026-10-26","format":"reels"}'

Manage a series with PATCH /api/v1/schedule-series/{id} (applies to the next posts), POST …/pause, POST …/resume, and DELETE /api/v1/schedule-series/{id} to end it. Posts already published are kept.

Download a Reels video

1. Call POST /api/v1/carousels/{id}/video-exports. The response has an id and status queued.
2. Check GET /api/v1/carousels/{id}/video-exports/{exportId} until it is ready, then download from video.url.
3. The link is valid for 24 hours (video.expiresAt). The same request doesn't create a new video or count again toward the daily limit.

curl -X POST https://posto.id/api/v1/carousels/<id carousel>/video-exports \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"secondsPerSlide":3,"transition":"fade"}'

With an AI assistant (MCP)

Ask your assistant, for example "Schedule this carousel as a Reel on Friday at 7 pm" or "Repost this carousel every Monday and Thursday at 7 pm, 8 times". The tools used: schedule_post (with the Reels format), create_schedule_series, list_schedule_series, pause_schedule_series, resume_schedule_series, end_schedule_series, and export_reels_video. The assistant repeats the schedule rule to you before creating a series and asks for confirmation before ending one.

More AI assistant tools

• Accounts & posts: list_accounts (connected accounts per brand, caption limits per platform), get_tiktok_creator_info (allowed TikTok privacy options), list_posts, get_post (status & per-platform links, failure reasons), update_post, and cancel_post.
• AI-credit-safe: create_carousel with planOnly: true returns the expected slides & AI credits without charging; strictSlides: true refuses when slides would be reduced. idempotencyKey makes retries safe (no double charge). get_carousel includes captionLimits per platform.
• No API key in Claude: add Posto as a custom connector in claude.ai with the URL https://posto.id/mcp. See Connect Posto to Claude as a custom connector.

Updates via webhook

Add a webhook for the series.paused event (series paused, automatically or manually) and series.ended (series finished or ended). The post.published and post.failed events now also include format and seriesId.

Still stuck? Contact [email protected].