LinkedIn API Error ReferenceComplete troubleshooting guide with solutions

Comprehensive reference for LinkedIn API errors. Find solutions and troubleshoot common integration issues.

9error codes
4categories
API v2

Error Categories

Authentication

3 errors

Permissions

2 errors

Content

2 errors

Media

2 errors

All Error Codes

#Authentication

unauthorizedrefresh-token

LinkedIn access token is invalid or expired. Please reconnect your LinkedIn account.

Solution:

Your LinkedIn access token is no longer valid. This can happen after 60 days (default token lifetime) or if you revoked app access. Reconnect your account in settings.

invalid tokenrefresh-token

LinkedIn access token is invalid or expired. Please reconnect your LinkedIn account.

Solution:

Your token is expired or malformed. LinkedIn access tokens typically last 60 days. Reconnect to get a new token.

expired tokenrefresh-token

LinkedIn access token is invalid or expired. Please reconnect your LinkedIn account.

Solution:

LinkedIn access tokens expire after 60 days by default. You need to reconnect your LinkedIn account to get a fresh token.

#Permissions

insufficient permissionsrefresh-token

Missing required LinkedIn permissions. Please reconnect with all required scopes.

Solution:

You didn't grant all required permissions when connecting. Reconnect your LinkedIn account and make sure to grant all requested permissions including w_member_social.

missing permissionrefresh-token

Missing required LinkedIn permissions. Please reconnect with all required scopes.

Solution:

The app needs additional permissions. Common permissions include: r_liteprofile, r_emailaddress, w_member_social. Reconnect and approve all scopes.

#Content

spamuser-error

Content violates LinkedIn policies or has been flagged as spam.

Solution:

LinkedIn's spam detection flagged your content. Avoid excessive links, promotional language, or repetitive posts. Follow LinkedIn's Professional Community Policies.

blockeduser-error

Content violates LinkedIn policies or has been flagged as spam.

Solution:

Your content or account has been blocked. Review LinkedIn's Professional Community Policies. You may need to contact LinkedIn support if you believe this is an error.

#Media

media too largeuser-error

Media file is too large or format not supported by LinkedIn.

Solution:

LinkedIn image limit: 10MB. Video limit: 5GB (200MB recommended). Compress your media files to meet these size requirements.

media unsupporteduser-error

Media file is too large or format not supported by LinkedIn.

Solution:

Supported formats - Images: PNG, JPG, GIF. Videos: MP4 (H.264 codec recommended). Convert your media to a supported format.

Best Practices

Error Handling

  • Implement automatic retries for rate limit and service errors
  • Store refresh tokens securely and handle token refresh flows
  • Log all errors with context for debugging
  • Show user-friendly error messages in your UI

Prevention Tips

  • Validate content before sending to LinkedIn API
  • Compress images and optimize media before upload
  • Implement rate limiting in your application
  • Follow LinkedIn's Professional Community Policies

Need Help with LinkedIn Integration?

Our API manages token refresh, permissions, and content validation automatically.