Facebook Pixel
ApiLinkedin posts

List scheduled posts

Every scheduled post you can see — your own plus any in a workspace you belong to. A database-only read that makes no LinkedIn call, so it spends none of your LinkedIn quota. It is still paced like every other call on the account (roughly one every 3 seconds), so read it when you need it rather than polling it in a loop. Use it to check whether a post went out: `status` is DRAFT, PENDING, PUBLISHED or FAILED, `publishedUrl` is set once it is live, and `lastError` carries the reason a FAILED post did not publish.

GET/posts/schedule/list
Authentication requiredPosts

Code Examples

curl -X GET 'https://api.connectsafely.ai/linkedin/posts/schedule/list' \
-H 'Authorization: Bearer <your_api_key>'

Every scheduled post you can see — your own plus any in a workspace you belong to. A database-only read that makes no LinkedIn call, so it spends none of your LinkedIn quota. It is still paced like every other call on the account (roughly one every 3 seconds), so read it when you need it rather than polling it in a loop.

Use it to check whether a post went out: status is DRAFT, PENDING, PUBLISHED or FAILED, publishedUrl is set once it is live, and lastError carries the reason a FAILED post did not publish.

Parameters

NameInRequiredTypeDescription
accountIdqueryNostringOnly posts for this connected account.
fromqueryNostringEarliest scheduledAt to include.
toqueryNostringLatest scheduledAt to include.
statusqueryNostring
limitqueryNointeger

Request Body

No request body.

Responses

StatusDescription
200Scheduled posts
401Unauthorized
500Server error

200 Response Parameters

NameTypeDescription
successboolean
countinteger
postsarray

200 Example

{
  "success": true,
  "count": 25,
  "posts": [
    {
      "id": "12345",
      "accountId": "acc_12345",
      "content": "example_value",
      "scheduledAt": "example_value",
      "timezone": "2024-01-15",
      "status": "active",
      "publishedUrl": "https://linkedin.com/in/example",
      "publishedAt": "example_value",
      "lastError": "example_value",
      "attempts": 0,
      "boostPostId": "12345",
      "companyUrn": "Acme Inc"
    }
  ]
}

401 Response Parameters

NameTypeDescription
errorstring

401 Example

{
  "error": "example_value"
}

500 Response Parameters

NameTypeDescription
errorstring

500 Example

{
  "error": "example_value"
}

On this page