Scheduling posts

Pekto publishes scheduled posts through the social accounts you connected in the app (Schedule in the Pekto dashboard). Connect an account there first; the API can list and use accounts but not connect them.

1. Find the account

curl "$PEKTO_API/social-accounts" -H "Authorization: Bearer $PEKTO_API_KEY"

Use the id of the account you want to post from.

2. Schedule the post

curl -X POST "$PEKTO_API/scheduled-posts" \
  -H "Authorization: Bearer $PEKTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "social_account_id": "a1b2…",
    "post_type": "text",
    "caption": "Five personal branding mistakes I see every week. Which one are you fixing first?",
    "scheduled_for": "2026-11-03T09:00:00Z",
    "project_id": "6f1c…"
  }'

Field	Notes
`post_type`	`text` (default), `image` or `document`.
`caption`	Up to 3,000 characters.
`scheduled_for`	A future ISO 8601 time with a time zone.
`project_id`	Optional: links the post to a project you own.
`media_urls`	Required for `image` and `document` posts. See below.

Image and document posts

media_urls must be files in your own Pekto media folder: a storage path such as <your-user-id>/carousel.pdf, or that file’s public URL. Files you schedule from the Pekto app are stored there. Other URLs are refused with 400 invalid_media. To post a carousel as a LinkedIn document, open the project in Pekto and use Publish and Schedule in the editor: it builds the PDF and schedules the post for you.

Manage posts

# scheduled and published posts
curl "$PEKTO_API/scheduled-posts?limit=25" -H "Authorization: Bearer $PEKTO_API_KEY"

# delete a post that hasn't been published (draft, pending or failed)
curl -X DELETE "$PEKTO_API/scheduled-posts/$POST_ID" -H "Authorization: Bearer $PEKTO_API_KEY"

Published posts can’t be deleted through Pekto; remove them on the platform. Scheduling needs social:write; listing needs social:read.

Get started

MCP

Guides

Reference

Scheduling posts

1. Find the account

2. Schedule the post

Image and document posts

Manage posts

​1. Find the account

​2. Schedule the post

​Image and document posts

​Manage posts

1. Find the account

2. Schedule the post

Image and document posts

Manage posts