Drafts

Schedule Post

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

POST /v1/posts/{id}/schedule takes an existing draft and either publishes it immediately or places it in the posting queue. publish_at drives the behaviour: 'now' publishes straight to LinkedIn, 'next-slot' resolves the next free slot from the account's posting schedule, and an ISO-8601 timestamp schedules that exact time.

timezone is an IANA name and is required for everything except 'now', because a wall-clock time without a zone is ambiguous. Media can be attached at schedule time with post_type, media_url and media_mime_type if it was not attached to the draft.

post/v1/posts/{id}/schedule

Request

  • Base URL: https://api.linkedmash.com
  • URL: https://api.linkedmash.com/v1/posts/{id}/schedule
  • Auth: one of:
    • OAuth 2 (client credentials, token URL https://api.linkedmash.com/auth/oauth/token, scopes: content:write)
    • HTTP bearer
    • API key in header linkedmash-api-key

Path parameters

idstring required
Example:drf_8f3a21c9

The id of the draft to schedule.

Request body

timezonestring

IANA timezone. Required unless publish_at is 'now'.

post_typestring

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

media_urlstring uri

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

media_mime_typestring

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

Example request

{
  "timezone": "Europe/Berlin"
}

Response

Successful response.

statusboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.