LinkedIn Integration
Connect your LinkedIn company page to Outermind so your AI agents can publish posts, share articles, take part in the comments under your posts, and report on how the page is performing.
Overview
Outermind connects to LinkedIn through its own registered LinkedIn app. You do not create a LinkedIn developer app, and you never enter or handle LinkedIn credentials: you sign in to LinkedIn, approve the permissions on LinkedIn's own consent screen, and Outermind stores the resulting access token encrypted.
There are two kinds of LinkedIn connection:
| Connection | Who connects it | Where |
|---|---|---|
| Company page | An administrator of the LinkedIn Page | This guide: Capabilities > Connections > LinkedIn |
| Personal profile | Each employee, for their own Personal Assistant | PA Hub; see Personal Assistant LinkedIn Integration |
Both kinds use the same Outermind LinkedIn app and the same three agent tools. What an agent can do depends on which kind of connection it is using (see Company page and personal profile differences).
Use Cases
- Company announcements - Draft and publish posts and article shares on your company page
- Community management - Find comments nobody has answered yet and reply under them
- Reporting - Track followers, page views and post performance
Before You Start
- Subscription - The LinkedIn Tools feature must be enabled for your organization. Company page connections need the Workforce plan or higher; a person's own LinkedIn profile works on every plan. Below Workforce, a company page connection is refused before anything is sent to or read from LinkedIn.
- Page administrator - The LinkedIn account you sign in with must be an administrator of the LinkedIn Page you want to connect. Outermind only lists the pages your account administers.
- Console permission - Creating a connection needs permission to manage agents in the Outermind console.
Connecting a Company Page
-
Navigate to Capabilities > Connections > LinkedIn.
-
Click Add Connection.
-
Fill in the connection details:
Field Description Display Name The name shown in the console. Pre-filled from your organization name Connection Name A unique identifier: lowercase letters, numbers, hyphens and underscores. It cannot be changed later Daily Post Limit The most new posts agents may publish through this connection per day, from 1 to 100. Default: 5 -
Tick Authorization Confirmation to confirm you are authorized to manage this company page on behalf of your organization and agree to LinkedIn's API Terms of Use.
-
Click Connect LinkedIn. A popup opens on LinkedIn.
-
Sign in to LinkedIn if asked, review the permissions on LinkedIn's consent screen, and approve them.
-
If you administer more than one LinkedIn Page, the Select Company Page screen lists them. Choose the page to connect and click Connect Selected Page. If you administer exactly one page, it is connected automatically.
-
Back in the console, click Next: Select Tools, choose the capabilities to enable for this connection, and continue.
-
On Assign Tools, choose which agents can use the LinkedIn tools.
-
Click Done.
The connection now appears on the LinkedIn connections page with its status, the page name, and the day's post usage.
If LinkedIn reports that your account administers no pages, the connection is not saved. Check that you signed in with an account that is an administrator of the page, then connect again.
Permissions Requested
Outermind asks LinkedIn only for the permissions the agent tools use. LinkedIn shows the list on its consent screen before you approve.
Company page connection:
| Permission | What it lets Outermind do |
|---|---|
w_organization_social | Post, comment and react on behalf of the page |
r_organization_social | Read the page's posts, comments, reactions and post statistics |
w_organization_social_feed | Write to the page's social feed |
r_organization_social_feed | Read the page's social feed |
r_organization_followers | Read the page's follower data |
rw_organization_admin | Read the pages you administer, so the right one can be connected, and the page's admin settings |
Personal profile connection (connected from the PA Hub):
| Permission | What it lets Outermind do |
|---|---|
r_basicprofile | Read your basic profile (name and LinkedIn member ID), so posts are published as you |
w_member_social | Create posts and share content as you |
w_member_social_feed | Write to your social feed |
r_member_postAnalytics | Read how your posts performed |
r_member_profileAnalytics | Read your profile analytics |
r_1st_connections_size | Read how many first-degree connections you have |
Outermind does not request your email address or a LinkedIn sign-in identity scope.
What Agents Can Do
A LinkedIn connection gives agents three tools. Each tool has a small set of actions.
linkedin_posts
| Action | What it does | Risk tier |
|---|---|---|
list | Reads the posts this connection has published, newest first | read |
get | Reads one post with the comments under it and the reactions on it | read |
create | Publishes one post: plain text, an article shared with commentary, a reshare of an existing post, or a poll. Text up to 3000 characters, with optional @-mentions and one image (PNG, JPEG or GIF, up to 10 MB) | medium |
update | Rewrites the text of a published post | medium |
delete | Removes a published post. LinkedIn does not restore it | medium |
react | Adds this connection's reaction to a post: Like, Celebrate, Support, Love, Insightful or Funny | low |
unreact | Takes this connection's reaction back off a post | low |
linkedin_comments
| Action | What it does | Risk tier |
|---|---|---|
list | Reads the comments under one post, or sweeps recent posts for comments nobody has answered yet | read |
create | Adds a comment under a post, or replies under an existing comment. Up to 1250 characters | medium |
delete | Removes a comment this connection posted | medium |
linkedin_analytics
| Action | What it does | Risk tier |
|---|---|---|
get | Reads one performance report, chosen by metric: followers (follower counts, optionally broken down by industry, seniority, function and geography), page (page views and visitors over a window), shares (how posts performed), profile (a personal profile's own report) or activity_history (what this workspace has published through LinkedIn, read from Outermind's own records) | read |
A figure the report could not fetch is returned as unavailable, never as a zero.
Company page and personal profile differences
The same tools serve both kinds of connection, but LinkedIn offers different features to each:
| Capability | Company page | Personal profile |
|---|---|---|
| Publish posts, article shares and reshares | Yes | Yes |
| Publish polls | Yes | No |
| Edit and delete posts | Yes | Yes |
| Add a reaction | Yes | Yes |
| Remove a reaction | Yes | No, LinkedIn only allows this on linkedin.com |
| Comment and reply | Yes | Yes |
| Delete a comment | Yes | No, LinkedIn only allows this on linkedin.com |
| Sweep recent posts for unanswered comments | Yes | No, name the post instead |
| List published posts | From LinkedIn | From Outermind's own activity records |
followers, page and shares reports | Yes | No |
profile report | No | Yes |
Posts are always published as the connected page or person. An agent cannot choose a different author.
Oversight
Approvals follow the agent's autonomy level
Every action carries the risk tier shown in the tables above. An agent's autonomy level decides which tiers it runs without asking a person: Auto Approve Low runs read and low actions, Auto Approve Medium also runs medium, and Full Autonomy also runs high. See Risk tiers.
So whether a post waits for approval depends on the agent. An agent at Auto Approve Low asks before it publishes, edits or deletes a post or a comment; an agent at Auto Approve Medium or above does not. When a LinkedIn write is held for approval, the approver decides that one action. LinkedIn writes cannot be set to always allow.
Daily limits
- Posts - Each company page connection has a Daily Post Limit (default 5). Every new post counts, including article shares and reshares. Editing a post does not count, so a published post can always be corrected.
- Reads and reports - A company page connection also has daily budgets for reads (100 by default) and analytics reports (50 by default), which protect the LinkedIn quota.
- All counters reset at midnight UTC. When a limit is reached, the agent is told and nothing is sent to LinkedIn until the next day.
To change the post limit, open the connection on Capabilities > Connections > LinkedIn and edit Daily Post Limit.
Activity and logs
LinkedIn tool calls are recorded in the agent's run history and in the LinkedIn integration logs under Governance, with access tokens and personal data redacted.
How Outermind Handles LinkedIn Data
Outermind's handling of LinkedIn data is set out in full in the LinkedIn section of the Privacy Policy. In summary:
- Authorized access only - A company page can only be connected by an authorized administrator of that page.
- Shown only inside Outermind - LinkedIn data is displayed only within the Outermind application. It is never exported or passed to third parties, and is not shown on external websites or intranets.
- Kept separate - LinkedIn data is not combined with data from your other integrations or with third-party data, and each organization's LinkedIn data is isolated from every other organization's.
- Never used for advertising or audience building, sales prospecting, recruiting, CRM enrichment, account-based marketing, or eligibility decisions.
- Storage limits - Individual members' posts, comments and reactions are purged after 48 hours, and profiles of people who did not authorize the connection after 24 hours. Organization social activity is kept for up to 6 weeks (6 months for an organization that authenticated the connection), and organization reporting data for up to 1 year.
- Deletion - When you disconnect LinkedIn, or close your Outermind account, cached LinkedIn data is deleted within 10 days.
Managing a Connection
Open a connection from Capabilities > Connections > LinkedIn to see its status, token expiry and post usage.
- Refresh Token - Renews the access token. Outermind also renews it automatically when it expires.
- Re-authorize - Runs the LinkedIn sign-in again. Use it when the connection shows as expired or revoked, or when a refresh fails.
- Delete - Removes the connection. Delete its actions first.
Assigning Tools to Agents Later
If you skipped Assign Tools in the wizard, or want to give the tools to another agent:
- Navigate to Workforce > Agents > Agents & SMEs
- Edit the agent that should use LinkedIn
- In the Tools section, find the LinkedIn tools
- Check the boxes to enable them
- Save the agent
Troubleshooting
The connection is refused after sign-in
Cause: LinkedIn returned no pages that your account administers.
Solution: Sign in with a LinkedIn account that is an administrator of the page, then click Add Connection again.
Company page actions are refused with a plan error
Cause: Company page connections need the Workforce plan or higher.
Solution: A tenant administrator can upgrade on the Subscription page.
Actions fail because the token expired or was revoked
Solution: Open the connection and click Refresh Token. If that fails, click Re-authorize and sign in to LinkedIn again.
The daily limit was reached
Solution: Wait for the midnight UTC reset, or raise the connection's Daily Post Limit.
An action is refused on a personal profile
Cause: LinkedIn does not offer that action to personal profiles (see Company page and personal profile differences).
Solution: Use a company page connection, or carry out the action on linkedin.com.
The LinkedIn tools do not appear on an agent
Solution: Check that the connection is active, then assign the tools to the agent as described above.
Related Topics
- Personal Assistant LinkedIn Integration - Connect an employee's own LinkedIn profile
- Tools Overview - All available agent tools
- Agents - Configure agents to use tools
- Agent Runs - View tool execution logs