API operational
All platform guides
Platform guide

LinkedIn

Connect your personal profile or, when available, choose organization Pages you administer. Approve access on LinkedIn, then select the Pages to connect.

approval required3,000 characters9 media items

Capabilities at a glance

AnalyticsNot availableCommentsNot availableMessagesNot availableRemote deletionNot availableToken refreshNot available
01

Connect LinkedIn

Create the hosted connection URL on your server. The customer completes OAuth or the provider-specific credential form directly on PostGate.

Connection requestPostGate API
curl -X POST https://postgate.studio/api/profiles/connect \
  -H "Authorization: Bearer $POSTGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "platform": "linkedin",
  "profile_group_id": "grp_acme123",
  "return_url": "https://app.example.com/settings/social"
}'
02

Publish to LinkedIn

Use the connected profile ID as the target. Provider-specific fields live under post.options.linkedin so the unified envelope remains stable.

Post envelopePostGate API
{
  "post": {
    "body": "Launch day.",
    "options": {
      "linkedin": {
        "visibility": "PUBLIC",
        "disable_reshare": false
      }
    }
  },
  "profiles": [
    "pro_linkedin123"
  ],
  "media": [
    "med_01JXYZ"
  ]
}
03

Media and content limits

PostGate validates the request at creation and again at delivery. Account-level provider limits can be narrower than the general contract.

Text3,000 characters
LinksAllowed
Mediaimages and video · Up to 9
Image size8 MB
Video size5 GB
Video durationUp to 15 min
04

Operational notes

These constraints affect approval, connection health, or delivery behavior for this provider.

  • Standard member tokens require reconnection every 60 days.

  • Programmatic refresh is conditional on a LinkedIn-issued refresh token; inspect profile health for refreshability.

  • Organization publishing requires Community Management approval and a separate Page connection; only explicitly selected administered Pages are connected.

  • LinkedIn analytics, comments, messages, remote deletion and historical import are disabled for the current integration scope.

  • Historical import is not available: LinkedIn does not expose a public read API for a member’s own past shares without Community Management API partnership.

Check live capability before showing the option
Call GET /api/platforms. A provider appears only when it is enabled and configured for the current workspace.
Next guideBuild the complete post envelopeCompareAll platform capabilities