# LinkedIn API guide

> Publish text, an image or a video to a LinkedIn profile or Company Page. Platform key: linkedin.

**Source:** https://postprism.app/docs/platforms/linkedin  
**Updated:** 2026-10-10

---

|   |   |
| --- | --- |
| Platform key | `linkedin` |
| Text limit | 3,000 characters |
| Media | The first attachment is used: one image or one video. Without media the post is text only. |

## Things to know

- A Company Page connected in Postprism appears in `GET /api/v1/platforms` as `linkedin:org:<page id>`, next to the personal `linkedin` profile. Use that exact key in `platforms` and `platform_content`.
- LinkedIn accepts videos from 75 KB; the API accepts videos up to 100 MB.

## Settings

Optional LinkedIn options go in `platform_content.linkedin.settings`. Invalid values are rejected when you create or update the post, with a message naming the field.

| Field | Type | Description |
| --- | --- | --- |
| `visibility` | `"PUBLIC"` or `"CONNECTIONS"` | Who can see a post on a personal profile. Default `PUBLIC`. Company Page posts are always public. |

**platform_content.linkedin**

```
"linkedin": {
  "content": "Three things we learned rebuilding our onboarding…",
  "settings": { "visibility": "CONNECTIONS" }
}
```

## Example

**POST /api/v1/posts**

```
{
  "base_content": "Our autumn menu is here.",
  "platforms": ["linkedin"],
  "platform_content": {
    "linkedin": {
      "content": "Our autumn menu is here. Which drink first?"
    }
  },
  "scheduled_at": "2026-10-16T09:30:00Z"
}
```

Other platforms: [X (Twitter)](https://postprism.app/docs/platforms/twitter), [TikTok](https://postprism.app/docs/platforms/tiktok), [YouTube](https://postprism.app/docs/platforms/youtube), [Pinterest](https://postprism.app/docs/platforms/pinterest), [Bluesky](https://postprism.app/docs/platforms/bluesky). Writing limits for every network are in our [character limit](https://postprism.app/glossary/character-limit) reference, and the [LinkedIn scheduler](https://postprism.app/platforms/linkedin-scheduler) page covers scheduling from the app.
