LinkedIn Pages setup guide

Agents read and publish for your social pages and ad accounts.

Ways to connect

Company admins connect apps, on the Integrations page in Everdeck: open LinkedIn Pages, choose one of the ways below, follow its steps and fill in its fields. Everdeck checks what you enter before it saves anything, and asks you to confirm it’s you (your second factor) before you type any secret. How connecting works.

LinkedIn Pages can be connected 2 ways. Where there’s a key or token to paste, that’s usually the quickest.

Access token from your LinkedIn app

Token.

1. Create an app at https://www.linkedin.com/developers/apps and link it to your company page. A super admin of the page must verify the app (Settings tab).
2. On the Products tab, request the Community Management API. LinkedIn reviews the request: it needs a registered business, a verified business email, your website and a privacy policy. Use a new app that has no other products.
3. When it is approved, open https://www.linkedin.com/developers/tools/oauth/token-generator, choose the app, tick r_basicprofile, rw_organization_admin, r_organization_social, w_organization_social, r_organization_social_feed and w_organization_social_feed, sign in as a page admin and copy the token.
4. Paste the token and your company page ID: the number in your page admin URL, linkedin.com/company/12345678/admin.
5. Tokens last 60 days. Generate a new one and paste it here before then.

Field	What to enter
Access token	A secret: Everdeck saves it encrypted and never shows it again. Where to find it.
Company page ID	Text. For example 12345678.

Disconnecting deletes the credentials Everdeck saved, but Everdeck can't revoke them: the key, token or password itself keeps working at LinkedIn Pages until you delete or rotate it there.

Your LinkedIn app

Your OAuth app.

This way signs in with an OAuth app you create for LinkedIn Pages, as its steps describe: Everdeck never uses an app of its own. Register this redirect URI with your app:

https://everdeck.io/api/oauth/callback

Then save the app’s client ID and secret in Everdeck, on the connect page or under OAuth apps, and sign in.

1. Create an app at https://www.linkedin.com/developers/apps and link it to your company page. A super admin of the page must verify the app (Settings tab).
2. On the Products tab, request the Community Management API. LinkedIn reviews the request: it needs a registered business, a verified business email, your website and a privacy policy. Use a new app that has no other products.
3. On the Auth tab, add https://everdeck.io/api/oauth/callback as an authorized redirect URL.
4. Copy the Client ID and Primary Client Secret into the form, then sign in as an admin of the page.
5. LinkedIn access tokens last 60 days and most apps get no refresh token, so you will be asked to reconnect every 60 days.

Field	What to enter
Company page ID (optional)	Text. For example 12345678. Leave it empty if you administer one company page; when you administer several, Everdeck lists them.

The scopes Everdeck asks for:

• r_basicprofile
• rw_organization_admin
• r_organization_social
• w_organization_social
• r_organization_social_feed
• w_organization_social_feed

When you disconnect, Everdeck asks LinkedIn Pages to revoke the sign-in, then deletes the tokens it saved.

What agents can do

An agent uses an action only when its charter grants it, on the agent’s Tools tab, where you choose whether each one runs by itself (Auto), asks first or never runs. Each action has a risk tier: tier 3 actions, which customers or the public see, ask first unless you choose otherwise, and tier 4 actions (money, deleting things, access) always need a person. How tools and tiers work.

Actions marked Reads outside content return things people outside your company may have written. Agents treat what they read as information, never as instructions, and their riskier actions later in the same session need approval.

• Get company page detailsTier 0 · ReadReads outside contentlinkedin_get_organization

  Get the connected company page's name, vanity name, description, website, industry and staff size.

• List page postsTier 0 · ReadReads outside contentlinkedin_list_posts

  List the company page's posts with their URN, text, state and timestamps (milliseconds since epoch). Sponsored (dark) posts are included; they have feedDistribution NONE.

• Publish a page postTier 3 · ExternalReads outside contentlinkedin_create_post

  Publish a post on the company page now, as the page. Hashtags (#word) work. Set link_url and link_title to attach a link card. Returns the new post URN and its URL.

• Edit a page postTier 3 · ExternalReads outside contentlinkedin_update_post

  Replace the text of a published page post.

• Delete a page postTier 4 · Money or irreversibleReads outside contentlinkedin_delete_post

  Permanently delete a page post. Deleting a post that is already gone succeeds.

• List commentsTier 0 · ReadReads outside contentlinkedin_list_comments

  List comments on a post, or replies to a comment when given a comment URN. Returns each comment's URN, author URN (urn:li:person:… or urn:li:organization:…), text and time.

• Comment on a postTier 3 · ExternalReads outside contentlinkedin_comment_on_post

  Add a top-level comment to a post, as the company page.

• Reply to a commentTier 3 · ExternalReads outside contentlinkedin_reply_to_comment

  Reply to a comment on a post, as the company page.

• Get post statisticsTier 0 · ReadReads outside contentlinkedin_get_share_statistics

  Organic impressions, unique impressions, clicks, likes, comments, shares and engagement rate for the page: lifetime totals, per day or month between two dates (last 12 months only), or lifetime totals for specific posts.

• Get follower countTier 0 · ReadReads outside contentlinkedin_get_follower_count

  Total number of followers of the company page.

• List page activityTier 0 · ReadReads outside contentlinkedin_list_notifications

  Recent comments, admin comments, mentions and reshares on the company page's posts (kept for 60 days), with the post and comment URNs to act on.

Testing, problems and disconnecting

Everdeck checks the connection when you save it. On the connection’s page in Integrations, Test checks it again at any time.

If LinkedIn Pages later refuses the connection, for example because a key was deleted or a sign-in expired, the connection shows Needs attention on the Integrations page and the people who manage connections are told. Agents can’t use it until a company admin fixes it with Edit or Reconnect.

To stop agents using LinkedIn Pages, open the connection and select Disconnect. Agents stop using it at once and its saved credentials are deleted. What else happens depends on how it was connected: each way above says.