LinkedIn Pages
Publish to a LinkedIn company page and read its engagement and analytics
The LinkedIn Pages integration lets your agents manage a LinkedIn company page — publishing posts, reading the comments they draw, and reporting on follower and content performance.
To publish to a person's own profile instead, use the separate LinkedIn Profile integration.
This integration requires access to LinkedIn's Community Management API, which LinkedIn grants only after reviewing your application. Until that approval is in place, the tools below return 403.
Prerequisites
You need:
- A LinkedIn developer application approved for the Community Management API. LinkedIn requires this product to be the only one on its application, so it is a separate application from the one behind the LinkedIn integration.
- OAuth — The person connecting must hold the
ADMINISTRATORrole on the company page they want to manage.
Setup
- Open Integrations from the sidebar
- Select LinkedIn Pages from the catalog
- Click Add Integration Config
- Give the config a display name (e.g., "LinkedIn Pages - Company")
- Click Connect to start the LinkedIn OAuth flow and approve access
- Save the config
Using in Your Agent
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach LinkedIn Pages tools from the tools panel
- Tools are referenced as
linkedin_pages.create_post,linkedin_pages.get_share_statistics, etc.
Call list_administered_pages first. Every other tool takes an organization_id — the numeric part of the organization URN in those results.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
list_administered_pages | List the company pages the connected member administers | ReadOnly |
create_post | Publish a plain-text post to a company page | Reversible |
create_article_post | Publish a post that shares a link to a company page | Reversible |
list_posts | List posts published by a company page | ReadOnly |
delete_post | Permanently delete a post from a company page | Irreversible |
get_post_comments | Read the comments on a page post | ReadOnly |
create_comment | Reply to a post as the company page | Reversible |
get_follower_statistics | Lifetime follower counts by country, industry, function, seniority, and company size | ReadOnly |
get_share_statistics | Lifetime organic engagement — impressions, clicks, likes, comments, shares, and engagement rate | ReadOnly |
Limits
- On LinkedIn's Development tier, calls are capped at 500 per application and 100 per member per day. Production use requires the Standard tier.
- Share statistics cover a rolling 12-month window and exclude sponsored activity.
- Follower statistics do not include a total follower count, and each demographic segment returns at most its top 100 entries.
- LinkedIn does not scrape shared URLs, so link posts need their title and description supplied explicitly.
Handling LinkedIn data
LinkedIn's API terms place obligations on data pulled through these tools:
- Member social activity may be retained for at most 48 hours, and most member profile data for 24 hours.
- LinkedIn data may not be exported from Fruxon, combined with other data sources, or used for advertising, sales, or recruiting purposes.
- Data from a page may only be shown to administrators of that same page.