Schedule Post

Endpoint

Uses the same create post endpoint with scheduledFor instead of publishNow.

POST https://api.postpeer.dev/v1/posts

Request Body

Include scheduledFor (ISO 8601 datetime) and optionally timezone (IANA timezone string). Omit publishNow or set it to false.

Field	Type	Required	Description
`content`	string	Yes	The text body of your post
`platforms`	array	Yes	Platform targets (see Create Post)
`scheduledFor`	string	Yes	ISO 8601 datetime to publish
`timezone`	string	No	IANA timezone (default: `"UTC"`)
`mediaItems`	array	No	Media attachments

Example

curl -X POST "https://api.postpeer.dev/v1/posts" \
  -H "x-access-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "This post will go live tomorrow morning!",
    "platforms": [
      { "platform": "twitter", "accountId": "abc123" }
    ],
    "scheduledFor": "2026-03-29T09:00:00",
    "timezone": "America/New_York"
  }'

Response

{
  "success": true,
  "status": "scheduled",
  "postId": "post_xyz789",
  "scheduledFor": "2026-03-29T13:00:00.000Z",
  "platforms": [
    { "platform": "twitter", "success": true }
  ]
}

The scheduledFor in the response shows the UTC time the post will be published.

Timezone Support

Pass any IANA timezone string:

America/New_York
Europe/London
Asia/Jerusalem
Asia/Tokyo
UTC (default)

If no timezone is provided, scheduledFor is treated as UTC.

Credits

Credits are checked at scheduling time and again at publish time. If you run out of credits between scheduling and the scheduled time, the post will fail with an insufficient credits error.