LinkedIn Scheduled Posts

Overview

Lists posts queued for scheduled publishing to LinkedIn on this account, across every status (pending, processing, posted, failed, canceled).

Posts are created by passing scheduled_for to the LinkedIn publish endpoint instead of publishing immediately.

Endpoint

GET https://eranol.com/api/v1/social/linkedin/scheduled-posts

Query parameters

Field	Type	Required	Notes
from	string	No	ISO timestamp lower bound on scheduled_for
to	string	No	ISO timestamp upper bound on scheduled_for
page	integer	No	1-indexed page number. Default 1
limit	integer	No	Page size. Default 20, max 100

Response fields

Field	Type	Notes
id	string	The scheduled post's id — pass this to the cancel endpoint
platform	string	Always "linkedin" for this endpoint
payload	object	The original publish request body for this post
scheduled_for	string	ISO timestamp of when the post is/was due to publish
status	string	pending, processing, posted, failed, or canceled
fail_reason	string | null	Present when status is failed
result	object | null	Present when status is posted — the publish result
created_at	string	ISO timestamp of when the post was scheduled

Example response

{
  "scheduled_posts": [{
    "id": "a1b2c3d4-...",
    "platform": "linkedin",
    "payload": {
      "text": "Announcing this next week 📅",
      "media_urls": [],
      "visibility": "PUBLIC"
    },
    "scheduled_for": "2026-09-01T15:00:00.000Z",
    "status": "pending",
    "fail_reason": null,
    "result": null,
    "created_at": "2026-08-25T10:00:00.000Z"
  }],
  "count": 1,
  "page": 1,
  "limit": 20
}

Errors

Status	Meaning
401	Missing or invalid API key
402	Insufficient credits
500	Internal server error — try again or contact support