Post to LinkedIn

Reelspan posts to LinkedIn with LinkedIn's Posts, Videos, Images and Documents APIs, as the member who connected the account. You send the post once; Reelspan uploads the media, waits for LinkedIn to process it, and creates the post.

What you can post

Reelspan handles for you:

• LinkedIn's text format. LinkedIn treats characters such as ( ) [ ] { } < > @ * _ ~ | as markup; Reelspan escapes them so your text shows as written, and turns #hashtags into real LinkedIn hashtags.
• Multipart video upload in the parts LinkedIn asks for, then a wait while LinkedIn processes the video (up to 15 minutes) or document (up to 10 minutes).
• Images in parallel, kept in the order you sent them.

Connect the account

LinkedIn connects with a LinkedIn sign-in: in the dashboard go to Accounts → LinkedIn, or send a white-label connect link. Posts go to the personal profile of the member who signed in.

LinkedIn sign-ins last 60 days and LinkedIn gives no way to renew them, so the account has to be reconnected every 60 days. Reelspan marks it as needing a reconnect when it expires.

Company pages

Posting as a LinkedIn company page needs LinkedIn's Community Management API, which Reelspan doesn't have access to yet. Until it does, GET /v1/linkedin/pages returns an empty list and posts go to the member's profile.

curl "https://api.reelspan.com/v1/linkedin/pages?profile=my-brand" \
  -H "Authorization: Bearer $REELSPAN_API_KEY"

const { pages } = await reelspan.request('GET', '/v1/linkedin/pages', { query: { profile: 'my-brand' } });

pages = reelspan.request("GET", "/v1/linkedin/pages", query={"profile": "my-brand"})["pages"]

{ "success": true, "pages": [] }

Example

A PDF posted as a document carousel, visible to connections only:

curl -X POST https://api.reelspan.com/v1/posts/document \
  -H "Authorization: Bearer $REELSPAN_API_KEY" \
  -F "user=my-brand" \
  -F "platform[]=linkedin" \
  -F "title=2026 hiring guide" \
  -F "description=We put everything we learned about hiring engineers into 12 slides. #hiring #engineering" \
  -F "visibility=CONNECTIONS" \
  -F "[email protected]"

import { Reelspan } from 'reelspan';
import { readFile } from 'node:fs/promises';

const reelspan = new Reelspan();
const post = await reelspan.posts.document({
  user: 'my-brand',
  platforms: ['linkedin'],
  title: '2026 hiring guide',
  description: 'We put everything we learned about hiring engineers into 12 slides. #hiring #engineering',
  document: { data: await readFile('guide.pdf'), name: 'guide.pdf', type: 'application/pdf' },
  extra: { visibility: 'CONNECTIONS' },
});

from reelspan import Reelspan

reelspan = Reelspan()
post = reelspan.posts.document(
    "my-brand", "guide.pdf", "2026 hiring guide",
    description="We put everything we learned about hiring engineers into 12 slides. #hiring #engineering",
    extra={"visibility": "CONNECTIONS"},
)

Fields

On a document post, title names the document and the post text comes from description (or linkedin_description). The first two lines of the text show before "see more", so lead with the hook.

Limits

• Post text: 3,000 characters.
• Images: up to 20 per post; more are left out.
• Documents: PDF, PPTX, PPT, DOCX or DOC, up to 100 MB.
• Video size: your plan's upload limit (see Plans and limits).
• Shapes: 1:1 and 16:9 work best.

Good to know

• Result extras: video_urn, image_urns, or document_urn with content_type, file_size and filename.
• First comment: posted under the new post as the member.
• Analytics: the member's follower count, when your Reelspan workspace has LinkedIn statistics turned on (an account connected before that has to be reconnected). There are no per-post numbers.

Errors