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

# Setting Up LinkedIn OAuth App

> Complete guide to creating and configuring a LinkedIn OAuth application

## Prerequisites

* LinkedIn personal account
* LinkedIn company page (required for app creation with admin access)

## Step 1: Create LinkedIn Developer Account & App

1. Visit [https://developer.linkedin.com/](https://developer.linkedin.com/) and sign in
2. Click **"Create App"** and fill out the form:
   * **App name**: Choose a descriptive name
   * **LinkedIn Page**: Associate with your company page
   * **App logo**: Upload 100x100px PNG (recommended)
   * Accept LinkedIn's API Terms of Use

![LinkedIn App Creation Form](https://mintcdn.com/klavisai/WUyJFoTOOKq1g0EB/images/knowledge-base/linkedin_oauth_app/step1.png?fit=max\&auto=format\&n=WUyJFoTOOKq1g0EB\&q=85\&s=60b103ed82950036b1183cce88497fe2)

## Step 2: Configure OAuth Settings

1. Go to the **"Auth"** tab in your application dashboard
2. Add redirect URLs: `https://api.klavis.ai/oauth/linkedin/callback`

Here is an example of Klavis AI OAuth app configuration:

![OAuth Settings Configuration](https://mintcdn.com/klavisai/WUyJFoTOOKq1g0EB/images/knowledge-base/linkedin_oauth_app/step2.png?fit=max\&auto=format\&n=WUyJFoTOOKq1g0EB\&q=85\&s=bc878cce64265c7552418e8a0091872b)

## Step 3: Request Scopes

> [!NOTE]
>
> Klavis LinkedIn MCP Server uses the following OAuth scopes: `openid,profile,email,w_member_social`

1. Go to **"Products"** tab and request **"Shared on LinkedIn"** and **"Sign In with LinkedIn using OpenID Connect"**
2. Once approved, you can see **Client ID** and **Client Secret** from the **"Auth"** tab

Here is an example of Klavis AI OAuth app configuration:

![Product Access and Credentials](https://mintcdn.com/klavisai/WUyJFoTOOKq1g0EB/images/knowledge-base/linkedin_oauth_app/step3.png?fit=max\&auto=format\&n=WUyJFoTOOKq1g0EB\&q=85\&s=59f018b128a96070539408e4d5814432)

> [!TIP]
>
> You have successfully created a LinkedIn OAuth application! You now have your Client ID and Client Secret ready for integration with Klavis AI.

## (Optional) Step 4: White Labeling

> [!NOTE]
>
> White labeling allows you to customize the OAuth experience with your own branding instead of Klavis AI's.

If you want to use your own LinkedIn OAuth application with custom branding:

1. **Configure White Labeling**: Go to [https://www.klavis.ai/home/white-label](https://www.klavis.ai/home/white-label)
2. **Add Your Credentials**: Enter your LinkedIn **Client ID** and **Client Secret** from Step 3
3. **Set Redirect URI**: Use `https://api.klavis.ai/oauth/linkedin/callback` or your custom callback URL
4. **Initiate OAuth**: Use your client ID when starting the OAuth flow:

   ```javascript without SDK theme={null}
   // Example: Initiating LinkedIn OAuth with white-label
   const authUrl = `https://api.klavis.ai/oauth/linkedin/authorize?instance_id=${instanceId}&client_id=${yourClientId}`;
   window.location.href = authUrl;
   ```

   ```typescript TypeScript SDK theme={null}
   import { Klavis } from "@klavis/sdk";

   const klavis = new Klavis({
     apiKey: "YOUR_API_KEY"
   });

   // Example: Initiating LinkedIn OAuth with white-label
   const oauthUrl = await klavis.mcpServer.getOAuthUrl({
     serverName: Klavis.McpServerName.Linkedin,
     instanceId: instanceId,
     clientId: yourClientId,
     // redirectUri: YOUR_REDIRECT_URI,
     // scope: "YOUR_SCOPES", 
   });

   window.location.href = oauthUrl;
   ```

   ```python Python SDK theme={null}
   import webbrowser
   from klavis import Klavis
   from klavis.types import McpServerName

   klavis = Klavis(api_key="YOUR_API_KEY")

   # Example: Initiating LinkedIn OAuth with white-label
   oauth_url = klavis.mcp_server.get_oauth_url(
       server_name=McpServerName.LINKEDIN,
       instance_id=instance_id,
       client_id=your_client_id,
       # redirect_uri="YOUR_REDIRECT_URI",
       # scope="YOUR_SCOPES"
   )

   # Open OAuth URL in user's default browser
   webbrowser.open(oauth_url)
   ```

> [!TIP]
>
> For detailed white labeling implementation and code examples, see our [OAuth & White Labeling guide](https://www.klavis.ai/docs/auth/white-label.md).

## Resources

* [LinkedIn OAuth Documentation](https://docs.microsoft.com/en-us/linkedin/shared/authentication/authorization-code-flow)
* [Klavis OAuth & White Labeling Guide](https://www.klavis.ai/docs/auth/white-label.md)
* [Klavis White Label Dashboard](https://www.klavis.ai/home/white-label)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.