Overview
The LinkedIn Posts resource allows you to publish, schedule posts to your LinkedIn profile. Use these endpoints to: - Publish or Schedule text posts with optional media attachments - Specify exact date, time, and timezone for posting
Schedule a Post
Schedule a LinkedIn post to be published at a specific date and time. You can include text content and optionally attach images or videos.
POST
/linkedin/posts/scheduleRequest Body
| Parameter | Digitare | Required | Descrizione |
|---|---|---|---|
| post_text | string | Required | The content of the LinkedIn post. |
| schedule_date | string | Required | Date to publish the post. Format: YYYY-MM-DD (e.g., "2025-11-01") |
| time_and_zone | string | Required | Time with timezone offset. Format: HH:mm:ss+ZZZZ or HH:mm:ss-ZZZZ (e.g., "04:33:11+0100" for 4:33 AM UTC+1) |
| media_list | array | Optional | Optional list of media attachments. Each item should have filenamee file_url properties. |
| media_list.filename | string | Required | Name of the file you would like to attach (must include file extension). |
| media_list.file_url | string | Required | URL of the file. |
Example Request
json
{
"post_text": "Your LinkedIn post text",
"schedule_date": "2025-11-01",
"time_and_zone": "09:00:00+0000",
"media_list": [
{
"filename": "image.jpg",
"file_url": "https://example.com/image.jpg"
}
]
}Response
json
{
"success": true,
"message": "Post successfully scheduled.",
"scheduled_date": "2025-11-01T09:00:00+0000"
}Response Fields
| Field | Digitare | Descrizione |
|---|---|---|
| success | boolean | Indicates if the post was successfully scheduled |
| message | string | Confirmation message |
| scheduled_date | string | ISO 8601 datetime when the post will be published |
Publish a Post
Publish a post to LinkedIn instantly. You can include text content and optionally attach images or videos.
POST
/linkedin/posts/publishRequest Body
| Parameter | Digitare | Required | Descrizione |
|---|---|---|---|
| post_text | string | Required | The content of the LinkedIn post. |
| media_list | array | Optional | Optional list of media attachments. Each item should have filenamee file_url properties. |
| media_list.filename | string | Required | Name of the file you would like to attach (must include file extension). |
| media_list.file_url | string | Required | URL of the file. |
Example Request
json
{
"post_text": "Your LinkedIn post text",
"media_list": [
{
"filename": "image.png",
"file_url": "https://example.com/image.png"
}
]
}Response
json
{
"success": True,
"message": f"Successfully published post to LinkedIn. (Post ID: {linkedin_post_id}) (Post URL: {linkedin_post_url})",
}Response Fields
| Field | Digitare | Descrizione |
|---|---|---|
| success | boolean | Indicates if the post was successfully scheduled |
| message | string | Confirmation message along with the ID & URL of the published LinkedIn post |
Timezone Handling
Le time_and_zone parameter uses ISO 8601 timezone offset format. For example, "+0000" is UTC, "+0530" is IST (India), and "-0500" is EST (US Eastern). Make sure to include the correct offset for your target audience.