/📘 API Reference/Create Post

Create Post

Publish immediately or schedule for the future across any combination of connected accounts.

Endpoint

POST/post

Request body

Field	Type	Description
account_ids	string[]	One or more account IDs (required).
text	string	Post caption or body text.
scheduled_at	ISO 8601	Future publish time. Omit to publish now.
media_ids	string[]	Media library IDs to attach.
timezone	string	IANA timezone. Defaults to workspace setting.

Example

curl -X POST https://api.plansched.com/developers/v1/post \
  -H "Authorization: Bearer $PLANSCHED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_ids": ["acc_1a2b3c", "acc_4d5e6f"],
    "text": "Big launch today 🚀",
    "media_ids": ["med_9x8y7z"],
    "scheduled_at": "2026-08-01T15:30:00Z"
  }'

Response

{
  "id": "post_abc123",
  "status": "scheduled",
  "scheduled_at": "2026-08-01T15:30:00Z",
  "account_ids": ["acc_1a2b3c", "acc_4d5e6f"],
  "created_at": "2026-07-21T10:04:12Z"
}

On success, you'll get a post.scheduled webhook, then post.published (or post.failed) when the scheduled time is reached.

API Reference → List Posts

Continue →