> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiveku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect LinkedIn for Social Posting

> Connect your LinkedIn profile instantly, or set up your own LinkedIn app for company-page posting

LinkedIn has two connection paths in Hiveku:

* **Quick connect** — uses Hiveku's LinkedIn app. No setup; two clicks. Available whenever the Quick connect button appears on the LinkedIn card.
* **Your own LinkedIn app (BYOK)** — your brand on the consent screen, your API quota. Personal-profile posting works instantly; **company-page posting requires LinkedIn's approval** of your app (days to weeks).

<Tip>
  Just want LinkedIn working today? Use Quick connect. Set up your own app later — switching preserves your post history.
</Tip>

## Quick Connect

<Steps>
  <Step title="Open the connect dialog">
    Go to **Marketing > Social > Accounts** and click **Connect Account** on the LinkedIn card.
  </Step>

  <Step title="Choose profile or company page">
    Pick **Personal profile** or **Company page**, click **Connect**, and approve LinkedIn's popup. For company pages, Hiveku lists the pages where you're an admin — pick the ones to connect.
  </Step>
</Steps>

## Your Own LinkedIn App (BYOK)

<Steps>
  <Step title="Create the app">
    Go to [developer.linkedin.com](https://developer.linkedin.com) → **My Apps** → **Create App**. You must associate it with your **LinkedIn Company Page**.
  </Step>

  <Step title="Verify the app">
    On the **Settings** tab, generate the verification URL and have the Page's super admin approve it (the link is valid for 30 days).
  </Step>

  <Step title="Add the instant products">
    On the **Products** tab, add **Sign In with LinkedIn using OpenID Connect** and **Share on LinkedIn**. Both activate immediately and enable personal-profile posting.
  </Step>

  <Step title="Request Community Management API (for company pages)">
    To post as your company page, also request the **Community Management API** product. LinkedIn reviews the request:

    * Use a **business email address** on the form — applications from gmail.com and similar are rejected
    * Your company must be a registered legal entity with a real website
    * Approval typically takes days to a couple of weeks

    Personal-profile posting works while you wait.
  </Step>

  <Step title="Add the redirect URL">
    On the **Auth** tab, add:

    ```
    https://app.hiveku.com/api/oauth/linkedin/callback
    ```

    Then copy the **Client ID** and **Client Secret**.
  </Step>

  <Step title="Connect in Hiveku">
    In the connect dialog, expand **Use your own app**, register the Client ID/Secret as an OAuth app, and click **Connect with your app**.
  </Step>
</Steps>

## Good to Know

* **LinkedIn access tokens last 60 days** and usually can't renew silently. When a connection expires, Hiveku sends you a "Reconnect LinkedIn" notification — reconnecting takes two clicks and history is preserved.
* If a company-page consent fails with a permissions error on your own app, the Community Management API product hasn't been approved yet — post from your personal profile in the meantime.
* A rejected Community Management application can't be re-submitted on the same app; you'd create a fresh app and apply again.
