Skip to main content
POST
Schedule a social post

Authorizations

Authorization
string
header
required

Pekto API key (pekto_live_...), an OAuth 2.1 access token from Pekto sign-in (used by MCP clients), or a Pekto user session token.

Body

application/json
social_account_id
string<uuid>
required

ID of connected social account

post_type
enum<string>
default:text
required
Available options:
text,
image,
document
caption
string
required

Post commentary text

scheduled_for
string<date-time>
required

ISO 8601 schedule date/time

media_urls
string[]

Files you uploaded to Pekto: scheduled-media paths (<user_id>/file.pdf) or their public URLs. Required for image and document posts.

Maximum array length: 20

Response

201

Created scheduled post