LinkedIn Integration
Connect your LinkedIn Company Pages to Iverton AI for B2B marketing, content publishing, audience analytics, and lead management.
Overview
The LinkedIn integration uses OAuth 2.0 to securely connect your company pages. Once connected, you can:
- Publish posts to your LinkedIn Company Page
- Track engagement and follower analytics
- Monitor company page performance
- Schedule content in advance
- Integrate with lead generation workflows
Prerequisites
Before connecting, ensure you have:
- A LinkedIn personal account
- Admin access to the LinkedIn Company Page you want to connect
- The Company Page must be published (not in draft)
Admin Access
If you're not an admin, ask a current admin to add you at: Company Page → Admin tools → Manage admins
Connecting LinkedIn
Step-by-Step Connection
- Go to Integrations in the main sidebar
- Find LinkedIn in the Social Media category
- Click Connect
- A LinkedIn login popup will appear
- Sign in with your personal LinkedIn account
- Review and approve the permissions Iverton AI is requesting
- Select which Company Pages you want to connect
- Click Allow to complete the authorization
Permissions Requested
Iverton AI requests these LinkedIn permissions:
| Permission | Scope | What It Allows |
|---|---|---|
| Profile access | r_liteprofile | Read your basic profile info |
| Email access | r_emailaddress | Read your email for account linking |
| Company page posting | w_member_social | Post content on behalf of your page |
| Organization access | r_organization_social | Read page analytics and followers |
| Organization posting | w_organization_social | Publish to company pages |
Page Selection
After authorization, you'll see all Company Pages where you have admin access. Select the pages you want to manage in Iverton AI.
If you don't see a page:
- Verify you have Admin (not just Analyst) role on the page
- Check that the Company Page is published
- Log out of LinkedIn and try connecting again
Features
Content Publishing
Publish professional content directly to your LinkedIn Company Page.
Supported Content Types
| Content Type | Supported | Notes |
|---|---|---|
| Text posts | Yes | Up to 3,000 characters |
| Single image | Yes | 1:1, 1.91:1, or 4:5 ratio |
| Multi-image posts | Yes | Up to 9 images |
| Video | Yes | Up to 10 minutes |
| Documents (PDF) | Yes | Great for slides and guides |
| Articles | Coming soon | Long-form content |
| Polls | No | Not available via API |
Posting Options
- Post immediately
- Schedule for a specific date and time
- Save as draft for review
- Add to content queue
Best Practices
- Posts with images get 2x more engagement
- Keep text concise but informative
- Use line breaks for readability
- Tag relevant companies or individuals when appropriate
- Include a clear call-to-action
Analytics & Insights
Track how your Company Page content performs.
Available Metrics
| Metric | Description |
|---|---|
| Impressions | Number of times content was displayed |
| Unique impressions | Number of unique members who saw content |
| Clicks | Total clicks on content, links, or page |
| Reactions | Likes, celebrates, supports, insightful, curious |
| Comments | Number of comments on posts |
| Shares | Number of times content was shared |
| Engagement rate | (Clicks + Reactions + Comments + Shares) / Impressions |
Follower Analytics
- Total follower count
- New followers over time
- Follower demographics (industry, seniority, location)
- Follower sources (organic, sponsored)
Page Performance
- Page views
- Unique visitors
- Custom button clicks
- Career page activity
Lead Management
Integrate LinkedIn with your lead workflows.
Lead Capture
- Sync leads from LinkedIn Lead Gen Forms (if using LinkedIn Ads)
- Automatically create contacts in Iverton AI CRM
- Trigger nurture sequences based on lead source
Lead Enrichment
- View LinkedIn profile data for contacts
- Track professional details (title, company, industry)
- Identify decision-makers in target accounts
Data Syncing
Sync Schedule
| Data Type | Sync Frequency |
|---|---|
| Published posts | Real-time |
| Post engagement | Every 30 minutes |
| Follower count | Every hour |
| Full analytics | Daily |
Manual Sync
To force an immediate sync:
- Go to Integrations → LinkedIn
- Click Sync Now
- Wait for the sync to complete (typically under a minute)
Token Management
Token Lifecycle
LinkedIn access tokens expire after 60 days. Iverton AI handles token refresh automatically:
- Initial Connection: You authorize and we receive an access token
- Token Storage: Token is encrypted and stored securely
- Automatic Refresh: We refresh the token before it expires
- Notification: You're notified only if manual re-authorization is needed
Re-Authorization
If your connection expires:
- Go to Integrations → LinkedIn
- You'll see a warning about expired credentials
- Click Reconnect
- Complete the LinkedIn authorization flow
- Select your pages again
Re-authorization is typically needed when:
- LinkedIn session was terminated (password change, security event)
- You revoked Iverton AI's access in LinkedIn settings
- Token refresh failed due to extended inactivity
LinkedIn Ads Integration
If you're running LinkedIn Ads, you can connect your ad account for campaign insights.
Connecting LinkedIn Ads
- Ensure your LinkedIn account has access to the ad account
- Go to Integrations → LinkedIn
- Click Connect Ad Account
- Select the ad account from the list
- Grant the additional permissions
Ads Permissions
| Permission | What It Allows |
|---|---|
r_ads | View ad campaigns and performance |
r_ads_reporting | Access detailed ad analytics |
Available Ad Metrics
- Campaign performance (impressions, clicks, CTR)
- Spend and budget utilization
- Conversion tracking
- Audience insights
- Lead form submissions
Troubleshooting
Common Issues
"Company Page not appearing"
- Verify you have Admin role (not Analyst)
- Check that the page is published, not in draft
- Try logging out of LinkedIn in your browser, then reconnect
"Cannot publish posts"
- Verify the
w_organization_socialpermission was granted - Check that you're posting to a Company Page, not a personal profile
- Ensure content meets LinkedIn's community guidelines
"Analytics not showing"
- New pages may take 24 hours to populate analytics
- Verify the
r_organization_socialpermission - Check that the page has had recent activity
"Token expired" error
- Click Reconnect in the integration settings
- Complete the full authorization flow again
- If issues persist, revoke access in LinkedIn settings and reconnect fresh
"Rate limit exceeded"
- LinkedIn has strict API rate limits
- Wait 24 hours for limits to reset
- Reduce posting frequency if this happens regularly
LinkedIn API Limitations
LinkedIn's API has some restrictions to be aware of:
| Limitation | Details |
|---|---|
| Post frequency | 100 posts per day per organization |
| Image size | Max 8 MB per image |
| Video size | Max 200 MB per video |
| Character limit | 3,000 characters per post |
| API rate limits | Varies by endpoint (typically 100 calls/day for some) |
Disconnecting
To remove the LinkedIn integration:
- Go to Integrations → LinkedIn
- Click Disconnect
- Confirm the disconnection
To fully revoke access, also remove Iverton AI in LinkedIn:
- Go to LinkedIn Settings → Data privacy
- Click Permitted services
- Find Iverton AI and click Remove
API Endpoints Reference
For developers integrating with the LinkedIn API:
GET /api/oauth/linkedin - Initiate LinkedIn OAuth
GET /api/oauth/linkedin/callback - OAuth callback handler
GET /api/social-accounts - List connected accounts
DELETE /api/social-accounts/linkedin/:id - Disconnect account
POST /api/oauth/refresh/linkedin/:id - Refresh access token
GET /api/oauth/status/linkedin/:id - Check connection status
Environment Variables
For self-hosted deployments:
# LinkedIn OAuth credentials
LINKEDIN_CLIENT_ID=your-client-id
LINKEDIN_CLIENT_SECRET=your-client-secret
LINKEDIN_REDIRECT_URI=https://your-domain/api/oauth/linkedin/callback
Next: Email Providers