Cue
Platforms

LinkedIn

Publishing to LinkedIn with Cue

Connect your LinkedIn account to schedule and publish posts through Cue.

Overview

LinkedIn is a professional networking platform where you can share updates, articles, and engage with your professional network. Cue integrates with the LinkedIn API to publish content on your behalf.

Sign up for a LinkedIn account at linkedin.com.

Authentication

LinkedIn uses OAuth 2.0 for secure authentication. You don't need to create API credentials - Cue handles this for you.

Connecting Your Account

  1. Go to Profiles in your Cue dashboard
  2. Click Connect Account on a profile
  3. Select LinkedIn
  4. You'll be redirected to LinkedIn to authorize access
  5. Sign in and grant Cue permission to post on your behalf
  6. You'll be redirected back to Cue automatically

Your credentials are never shared with Cue.

Permissions

Cue requests the following permissions:

  • w_member_social - Post content on your behalf
  • r_liteprofile - Read your basic profile information

Disconnecting

To disconnect your LinkedIn account, go to your profile and click Disconnect next to the LinkedIn connection. This revokes Cue's access to your account.

You can also revoke access from LinkedIn Settings under Data privacy > Other applications.

Content Limits

LinkedIn enforces the following limits on posts:

LimitValue
Characters3,000
ImagesUp to 9 per post
Video length10 minutes
File size8 MB (images), 200 MB (videos)

Cue automatically validates your content length before publishing to prevent errors.

Publishing a Post

curl -X POST https://api.oncue.so/v1/posts \
  -H "Authorization: Bearer cue_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_abc123",
    "platforms": {
      "sac_linkedin1": {
        "items": [{ "content": "Excited to share insights from our latest project!" }]
      }
    },
    "publishNow": true
  }'
const response = await fetch("https://api.oncue.so/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer cue_sk_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "prf_abc123",
    platforms: {
      sac_linkedin1: {
        items: [{ content: "Excited to share insights from our latest project!" }],
      },
    },
    publishNow: true,
  }),
});

Schedule for Later

curl -X POST https://api.oncue.so/v1/posts \
  -H "Authorization: Bearer cue_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_abc123",
    "platforms": {
      "sac_linkedin1": {
        "items": [{ "content": "Scheduled professional update" }]
      }
    },
    "scheduledAt": "2024-01-20T09:00:00-05:00"
  }'
const response = await fetch("https://api.oncue.so/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer cue_sk_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "prf_abc123",
    platforms: {
      sac_linkedin1: {
        items: [{ content: "Scheduled professional update" }],
      },
    },
    scheduledAt: "2024-01-20T09:00:00-05:00",
  }),
});

Response

{
  "data": {
    "id": "pst_xyz789",
    "profileId": "prf_abc123",
    "content": "Excited to share insights from our latest project!",
    "status": "queued",
    "scheduledAt": null,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  },
  "message": "Post queued for publishing to 1 platform(s)"
}

Error Handling

LinkedIn API errors are translated into user-friendly messages:

Error CodeMeaningSolution
401Authentication failedReconnect your LinkedIn account
403Account restrictedCheck your LinkedIn account status
429Rate limit exceededWait and retry later
422Content validation failedCheck content limits

Common Issues

"Reconnect required" error

  • Your access token has expired or been revoked
  • Go to your profile and reconnect your LinkedIn account

"Content too long" error

  • Your post exceeds 3,000 characters
  • Shorten your message or consider writing a LinkedIn article instead

"Permission denied" error

  • Posting permissions were not granted during authorization
  • Reconnect your account and ensure you approve all requested permissions

"Account restricted" error

  • Your LinkedIn account may have restrictions
  • Check your account status on linkedin.com

Troubleshooting

Connection Issues

Cannot redirect to LinkedIn during OAuth

  • Check your internet connection
  • Try using a different browser
  • Disable browser extensions that might block redirects

OAuth returns error immediately

  • Your LinkedIn account may have restrictions
  • LinkedIn's OAuth service may be experiencing issues
  • Try again in a few minutes

"Access denied" after authorization

  • Ensure you clicked "Allow" on all permission requests
  • Some enterprise accounts may have restrictions
  • Contact your LinkedIn administrator if using a company account

Publishing Issues

Posts not appearing on LinkedIn

  • Check if your post is still in "queued" status
  • Wait a few minutes - publishing may take time
  • Check the post's platform status for error details

Hashtags not linking

  • LinkedIn hashtags must use the # symbol
  • Avoid special characters in hashtags
  • Hashtags are limited to 30 per post

Mentions not working

  • Use the person's full name for mentions
  • The mentioned user must be in your network

Best Practices

Content Guidelines

  • Lead with a compelling hook in the first two lines
  • Use line breaks for better readability
  • Include relevant hashtags (3-5 is optimal)
  • Ask questions to encourage engagement

Timing

  • Post during business hours for professional content
  • Tuesday through Thursday typically see higher engagement
  • LinkedIn analytics shows when your audience is most active

Professional Tone

  • Maintain a professional but authentic voice
  • Share insights, not just promotions
  • Engage with comments on your posts

Further Reading

On this page