Connecting LinkedIn

Connect your LinkedIn Company Page to bluekona.ai to analyze post performance, understand your professional audience, and optimize your B2B content strategy.

Prerequisites

Account Requirements

• LinkedIn Company Page (not a personal profile)
• Page Administrator or Analyst role
• Active LinkedIn account in good standing

Important Notes

• Personal LinkedIn profiles cannot be directly connected
• You must manage or have admin access to a Company Page
• The Page must be published and active

What is a Company Page?

A LinkedIn Company Page is different from your personal profile:

• Represents a business, organization, or brand
• Has followers (not connections)
• Provides Company Page analytics
• Required for B2B marketing on LinkedIn

Don't have a Page? Create one at linkedin.com/company/setup

Connection Process

Step 1: Initiate Connection

From your bluekona.ai dashboard:

1. Navigate to Settings > Social Connections or
2. Click Connect Platform
3. Select LinkedIn
4. Click Connect LinkedIn

Step 2: LinkedIn OAuth Authorization

You'll be redirected to LinkedIn's secure OAuth page:

1. Sign In

   • Log in with your LinkedIn credentials
   • Or authenticate if already signed in

2. Select Identity

   • LinkedIn may ask which account to use
   • Choose the account with admin access to your Company Page

3. Review Permissions

   • LinkedIn displays requested permissions
   • All permissions are read-only

4. Authorize

   • Click Allow or Authorize
   • Grant bluekona.ai permission to access your Page data

Step 3: Permissions Requested

bluekona.ai requests these read-only permissions:

LinkedIn API Permissions

• r_liteprofile - Read basic profile information
• r_organization_social - Read Company Page posts
• r_organization_followers - View Page follower data
• rw_organization_admin (read-only scope) - Access Page analytics

What these permissions allow:

• Access Company Page information
• Read published posts and updates
• View Page analytics and insights
• Track follower demographics
• Analyze engagement metrics

What we CANNOT do:

• Post on your Company Page
• Delete or edit posts
• Manage Page settings
• Invite Page followers
• Access employee connections
• View private messages

Step 4: Select Company Page

After granting permissions:

1. LinkedIn shows your Company Pages
2. Select the Page(s) you want to connect
3. Confirm selection
4. Click Continue or Done

Step 5: Complete Connection

You're redirected back to bluekona.ai:

1. Success message confirms connection
2. LinkedIn Page appears in connected platforms
3. Initial data sync begins (2-5 minutes)

What Data is Collected?

Page Metrics

• Company name and description
• Industry and company size
• Follower count and growth
• Page views and visits
• Unique visitor count

Post Performance (Last 14 Days)

• Individual post metrics
• Impressions and reach
• Clicks and click-through rate
• Likes, comments, shares
• Engagement rate
• Social actions

Content Analysis

• Post text and captions
• Media types (image, video, document, article)
• Links shared
• Posting frequency
• Publishing times

Audience Insights

• Follower demographics (job function, seniority, industry)
• Geographic locations
• Company sizes of followers
• Engagement by audience segment

Understanding the Dashboard

After connecting, your LinkedIn Page appears in Social Connections:

Status Display

• Connected (Green) - Active and syncing
• Token Expiring Soon (Yellow) - Reconnection needed
• Token Expired (Orange) - Requires reconnection
• Error (Red) - Connection issue

Page Information

• Company logo
• Company name
• Follower count
• Last sync time
• Connection status

Quick Actions

• View Analytics - Jump to LinkedIn insights
• Reconnect - Refresh OAuth token
• Disconnect - Remove connection

Token Management

LinkedIn access tokens typically expire after 60 days.

Token Lifecycle

1. Active (Day 1-50): Normal operation
2. Expiring Soon (Day 51-58): Warning displayed
3. About to Expire (Day 59-60): Urgent notification
4. Expired (After Day 60): Connection inactive

Reconnecting

When token expires:

1. Click Reconnect button
2. Re-authorize through LinkedIn OAuth
3. Token refreshed for another 60 days
4. Historical data preserved

Running LinkedIn Audits

Single Platform Audit

1. Go to Dashboard or Analysis
2. Click Start Single Platform Audit
3. Select LinkedIn
4. Audit analyzes your Page content
5. Results ready in 2-5 minutes

The AI analyzes:

• Post performance by content type
• Best performing formats (articles, videos, carousels)
• Optimal posting times for B2B audience
• Engagement patterns
• Thought leadership content effectiveness
• Industry-specific benchmarks
• Follower growth drivers
• Click-through rate optimization

Cross-Platform Audit

With multiple platforms connected:

1. Click Start Cross-Platform Audit
2. LinkedIn analyzed alongside other platforms
3. Compare B2B vs B2C performance
4. Identify professional content strategies

Content Types Analyzed

Text Posts

• Status updates
• Company announcements
• Thought leadership

Key metrics:

• Impressions and reach
• Engagement rate
• Social actions

Image Posts

• Single image updates
• Visual content
• Infographics

Key metrics:

• Image views
• Click-through rate
• Share rate

Video Posts

• Native LinkedIn videos
• Educational content
• Company culture videos

Key metrics:

• Video views
• View completion rate
• Engagement rate

Article Posts

• Long-form content
• Published articles
• Industry insights

Key metrics:

• Article views
• Read time
• Share and comment depth

Document Posts

• PDF uploads
• Presentations
• Slide decks

Key metrics:

• Document views
• Page views within document
• Download/share rate

Link Posts

• External content shares
• Blog post promotions
• Resource sharing

Key metrics:

• Link clicks
• Click-through rate
• Engagement despite external link

Troubleshooting

Connection Issues

"No Company Pages found"

• Verify you have admin access to a Company Page
• Check you're logged into correct LinkedIn account
• Ensure Page is published and active
• Create a Company Page if you don't have one

"Insufficient permissions"

• You need admin or analyst role on the Page
• Ask the Page owner to grant you access
• Verify permissions in LinkedIn Page settings

"Authorization failed"

• Grant all requested permissions
• Try different browser or incognito mode
• Clear LinkedIn cookies and retry
• Disable browser extensions temporarily

"Connection timeout"

• LinkedIn's servers may be slow
• Wait a few minutes and try again
• Check your internet connection
• Verify LinkedIn platform status

Data Issues

No posts showing:

• Ensure Page has published posts in last 14 days
• Wait 5-10 minutes for initial sync
• Check posts are published (not drafts)
• Verify Page is active

Missing analytics:

• New Pages may have limited historical data
• Very recent posts need time for metrics
• Some metrics require minimum impressions
• Page needs to be active for analytics

Incomplete follower data:

• Follower demographics require minimum threshold
• LinkedIn provides aggregated data only
• Some insights only available to certain Page sizes

Role-Related Issues

Admin vs Analyst roles:

• Admin: Full Page management access
• Analyst: Analytics-only access
• bluekona.ai works with both roles
• Ensure role hasn't been revoked

Privacy & Security

What We Access

• Public Company Page information
• Published posts and analytics
• Follower demographics (aggregated)
• Page performance metrics

What We Don't Access

• Personal LinkedIn profile connections
• Employee personal information
• Private messages or InMail
• Recruitment or job posting data
• Company admin settings

Data Storage

• Page metrics stored for analysis
• OAuth tokens encrypted
• Used only for your insights
• Complies with LinkedIn's policies

LinkedIn API Compliance

bluekona.ai follows:

• LinkedIn Developer Agreement
• API Terms of Service
• Marketing Developer Guidelines
• Privacy and data protection laws

Disconnecting LinkedIn

From bluekona.ai

1. Go to Settings > Social Connections
2. Find your LinkedIn Page
3. Click Disconnect or Remove
4. Confirm action

What happens:

• Connection removed immediately
• Token revoked
• Historical audits preserved
• Can reconnect anytime

From LinkedIn

Revoke access from LinkedIn's side:

1. Log in to LinkedIn
2. Click your profile icon → Settings & Privacy
3. Select Data privacy
4. Click Permitted services
5. Find bluekona.ai
6. Click Revoke access

Or from your Company Page:

1. Go to your Company Page
2. Click Admin tools
3. Select Page settings
4. Navigate to Integrations
5. Remove bluekona.ai access

Best Practices

For Optimal Insights

• Run audits bi-weekly or monthly
• Post consistently (3-5 times per week ideal)
• Connect early to build historical data
• Use insights to refine B2B strategy

B2B Content Strategy

• Test different content formats
• Track thought leadership effectiveness
• Monitor professional audience engagement
• Identify industry-specific trends
• Analyze peak professional hours

Engagement Optimization

• Focus on content that drives comments
• Track share-worthy posts
• Monitor click-through rates for lead gen
• Identify follower growth content

Multiple Pages

• Connect multiple Company Pages
• Compare performance across brands
• Track subsidiary Pages
• Useful for holding companies

Understanding LinkedIn Metrics

Impressions

Number of times your post was displayed on LinkedIn.

Unique Impressions

Number of unique LinkedIn members who saw your post.

Clicks

Total clicks on your post, including comments, shares, and likes.

Click-Through Rate (CTR)

Percentage of impressions that resulted in clicks.

Engagement Rate

(Reactions + Comments + Shares) ÷ Impressions × 100

Social Actions

Likes, comments, shares, and follows resulting from your post.

Content Optimization Tips

Based on AI Analysis

Posting Timing:

• Professional hours (weekday mornings/lunch)
• Time zone considerations for global audience
• Industry-specific active times

Content Format:

• Video vs image vs text performance
• Document posts for lead generation
• Article posts for thought leadership

Messaging:

• Professional tone optimization
• Call-to-action effectiveness
• Hashtag strategy for B2B

Audience Targeting:

• Content by job function
• Seniority-level preferences
• Industry-specific messaging

Advanced Features

Follower Demographics

• Job functions and seniority
• Industries and company sizes
• Geographic distribution
• Competitive intelligence

Content Performance by Type

• Best format for your audience
• Length optimization for posts
• Visual vs text preference

Engagement Quality

• Comment depth and quality
• Share context and reach
• Follower acquisition posts

B2B Benchmarking

• Industry comparison
• Competitor positioning
• Professional network growth

Common Questions

Q: Can I connect my personal LinkedIn profile? A: No, only Company Pages are supported. Personal profiles don't have the necessary API access.

Q: Do I need LinkedIn Premium? A: No, any Company Page admin can connect regardless of Premium status.

Q: Will bluekona.ai post to my Page? A: No, we only have read-only access. We cannot post, edit, or delete content.

Q: Can I connect multiple Company Pages? A: Yes, if you have admin access to multiple Pages, connect each separately.

Q: How many followers do I need? A: No minimum required. Pages of any size can connect and benefit.

Q: What about LinkedIn Ads data? A: Currently, bluekona.ai focuses on organic post performance, not paid advertising metrics.

Next Steps

• Run your first LinkedIn audit
• Compare B2B vs B2C performance
• Understanding professional metrics
• Manage your connections

Need help? Check our troubleshooting guide or contact support.