Creating LinkedIn posts

Use create_post to publish from your member profile immediately or schedule for later. Posts support up to 3000 characters.

What a post can include

• Attachments: images or documents, passed as public HTTPS URLs. Each attachment can be a plain URL string or an object with url and filename.
• URLs: include the URL directly in the post text. Link preview cards are not supported.

Mentions, link preview cards, company-page publishing, and custom video thumbnails are not supported. Passing their compatibility fields refuses the post before anything is published or charged against the daily cap.

Scheduling

Pass schedule_at as an ISO 8601 datetime, for example '2026-03-10T09:00:00Z', to queue the post instead of publishing now. Times in the past and unsupported enhanced fields are rejected. Manage the queue with list_scheduled_posts and cancel_scheduled_post.

Safety limit

Posting has a daily cap of 10, shared between create_post and publish_draft. That is far more than anyone should post in a day; the cap exists to stop a runaway agent, not to constrain you.

Workflow tip

Have your agent draft the text, then confirm it with you before the tool is called. A published post is live to your whole network immediately. For content you want to refine over days, use drafts instead: save with save_draft, iterate, then publish_draft when ready. Your writing style guides feed into agent drafts too, so the more you tune them, the less editing each post needs.