How to Post to LinkedIn via API

Step-by-step

1. 1

   Connect LinkedIn inside a CodivUpload profile

   Dashboard → Profiles → Connect → LinkedIn. CodivUpload requests scopes for both personal posting (w_member_social) and organization posting (w_organization_social). The OAuth callback auto-detects which Company Pages the connected user has admin or content-admin rights on — those Pages become available as targets via the linkedin_page_id override.

2. 2

   Post to your personal profile

   Set platforms=["linkedin"] and omit linkedin_page_id. CodivUpload routes the post to LinkedIn's UGC endpoint, attributed to the connected personal account. Use linkedin_visibility to control reach: PUBLIC means anyone on or off LinkedIn can see it, CONNECTIONS limits visibility to your first-degree network.

   curl -X POST https://api.codivupload.com/v1/posts \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post_type": "text",
       "profile_name": "my_brand",
       "platforms": ["linkedin"],
       "description": "Three lessons from shipping our v2 API:\n\n1. Async beats elegant.\n2. Type-check the boundaries.\n3. Webhooks > polling, always.",
       "linkedin_visibility": "PUBLIC"
     }'

3. 3

   Post to a Company Page

   Pass linkedin_page_id with the Organization URN's numeric ID (find it in your Company Page's admin URL: linkedin.com/company/123456 → page ID is 123456). CodivUpload routes the call to LinkedIn's Organization shares endpoint, attributed to the Company Page itself rather than the admin user. Pages support the same content types as personal profiles plus a few extras (e.g. multi-image carousels).

   curl -X POST https://api.codivupload.com/v1/posts \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post_type": "image",
       "profile_name": "my_brand",
       "platforms": ["linkedin"],
       "media_urls": ["https://your-cdn.example.com/launch-banner.jpg"],
       "description": "Today we shipped CodivUpload v2 — the cross-platform publishing API that nine other platforms make harder than it has to be.",
       "linkedin_visibility": "PUBLIC",
       "linkedin_page_id": "123456789"
     }'

4. 4

   Attach images, video, or document carousels

   Set post_type=image with up to nine images for a carousel, post_type=video with a single MP4 URL, or post_type=document for PDF carousels (LinkedIn supports up to 300 pages). Animated GIFs are not supported through LinkedIn's API — convert to MP4 if you need motion. Use linkedin_page_id only when targeting a Company Page; for personal posts omit it entirely.

5. 5

   Schedule for later or use best-time scheduling

   Add scheduled_date in ISO 8601 UTC, or schedule_best_time=true to let CodivUpload pick the optimal slot based on the connected account's last 90 days of LinkedIn analytics. LinkedIn's algorithm rewards posts that get engagement in the first hour, so picking the right slot matters — best-time scheduling typically lifts initial engagement by 30-50% versus posting at random times.

Frequently asked