Schedule Post

Schedule a draft for publishing now, at the next open slot, or at a specific time. Requires a paid Creator or Lifetime plan.

POSThttps://api.linkedmash.com/v1/posts/{id}/schedule

Path parameters

idstringRequired

The id of the draft to schedule.

AuthorizationstringRequired

Your secret API key as a Bearer token.

publish_atstringRequired

'now', 'next-slot', or an ISO-8601 timestamp.

timezonestringOptional

IANA timezone. Required unless publish_at is 'now'.

post_typestringOptional

Media type to attach: text, image, video, or pdf.

media_urlstringOptional

Public URL of an image, video, or PDF to attach.

media_mime_typestringOptional

MIME type of the attached media (e.g., 'image/png').

{
  "status": true,
  "data": {
    "ok": true,
    "scheduleId": "sch_3a9f81d2",
    "runAtUTC": "2026-06-24T08:30:00.000Z"
  }
}