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
- Go to Profiles in your Cue dashboard
- Click Connect Account on a profile
- Select LinkedIn
- You'll be redirected to LinkedIn to authorize access
- Sign in and grant Cue permission to post on your behalf
- 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 behalfr_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:
| Limit | Value |
|---|---|
| Characters | 3,000 |
| Images | Up to 9 per post |
| Video length | 10 minutes |
| File size | 8 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 Code | Meaning | Solution |
|---|---|---|
401 | Authentication failed | Reconnect your LinkedIn account |
403 | Account restricted | Check your LinkedIn account status |
429 | Rate limit exceeded | Wait and retry later |
422 | Content validation failed | Check 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