# Connect Your Company LinkedIn Account For Social Login
### Before You Start - What You'll Need
Make sure you have these ready before beginning:
✅ **A LinkedIn account** (your personal or business account)
✅ **A LinkedIn Company Page** (this is required by LinkedIn - if you don't have one, [create here](https://www.linkedin.com/company/setup/new/))
✅ **Your company logo** saved as an image file (100x100 pixels, PNG or JPG format)
✅ **A business email address** (not a personal Gmail/Yahoo)
✅ **Your website's exact URL** (the web address where your job seekers log in)
> **Important Note:** You'll be doing the setup on LinkedIn's side, but you won't need to touch any code or configure anything technical yourself. The Artha Support Team will handle all the technical backend work once you share some information with them.
***
### Understanding Key Terms (Simple Glossary)
Before we begin, here are a few terms you'll see. Don't worry - you don't need to be an expert, just know what they mean:
**Developer Portal** - A special website where companies can connect their apps/websites with LinkedIn. Think of it as LinkedIn's control center for businesses.
**App/Application** - In this context, it's just a registered connection between your job portal and LinkedIn. You're not building software - you're just registering your website with LinkedIn.
**Client ID** - A unique identification number LinkedIn gives you (like a username). It's public and safe to share.
**Client Secret** - A secret password LinkedIn gives you (like a password). Keep this private and secure.
**OAuth** - A secure way for websites to let users log in using accounts from other services (like LinkedIn, Google, etc.). You don't need to understand how it works - just know it's the technology that makes "Sign in with LinkedIn" possible.
**Redirect URL** - The web page address where users land after logging in with LinkedIn. For your job portal, this is typically your login page.
**API** - A way for two computer systems to talk to each other. In this case, it's how your job portal communicates with LinkedIn.
***
### Step-by-Step Instructions
#### Step 1: Access LinkedIn's Developer Portal
**What you're doing:** Going to LinkedIn's special area where businesses can connect their websites.
1. Open your web browser and go to: [**https://www.linkedin.com/developers**](https://www.linkedin.com/developers)
2. Click the **"Sign In"** button in the top right corner
3. Log in using your LinkedIn account credentials (your normal LinkedIn username and password)
**You'll know you're in the right place when:** You see a page that says "LinkedIn Developers" at the top with options like "My Apps" and "Products."
***
#### Step 2: Create Your Application
**What you're doing:** Registering your job portal with LinkedIn so they know it's a legitimate website that should be allowed to use LinkedIn login.
1. Look at the top of the page and click on **"My Apps"**
2. Click the blue **"Create app"** button (usually on the right side)
**You'll know you're in the right place when:** You see a form asking for details about your application.
***
#### Step 3: Fill in Your Application Details
**What you're doing:** Telling LinkedIn basic information about your job portal.
Fill out the form with the following information:
**App name:** Give your application a name
* Example: "JobSphere Social Login" or "YourCompanyName Login"
* This is just for your reference - job seekers won't see this
**LinkedIn Page:** Select your company's LinkedIn page from the dropdown
* This is required by LinkedIn
* If you don't have a company page, you'll need to create one first
**App logo:** Upload your company logo
* Must be 100x100 pixels ([Resize here](https://www.iloveimg.com/resize-image))
* Must be PNG or JPG format
* This may appear when users log in, so use your official logo
**Privacy policy URL:** Enter your website's privacy policy page
* Example:
* This is required by LinkedIn
**Business email:** Enter your company email address
* Use your official business email (not personal email like Gmail)
* LinkedIn may send important updates to this email
**Legal agreement:** Check the box that says "I have read and agree to the LinkedIn API Terms of Use"
4. Click the blue **"Create app"** button at the bottom
**You'll know it worked when:** You see a success message and are taken to your app's dashboard (a page showing details about your new application).
***
#### Step 4: Get Your Client ID and Client Secret
**What you're doing:** Getting two special codes that LinkedIn generated for you. Think of these like a username and password that your website will use to communicate with LinkedIn.
1. On your app's dashboard, look for tabs at the top
2. Click on the **"Auth"** tab (short for "Authentication")
3. You'll see two important pieces of information:
* **Client ID** - This will be visible (a long string of random letters and numbers)
* **Client Secret** - This will be hidden behind dots. Click the **"Show"** button to reveal it
4. **Copy both of these and save them somewhere safe**
* You can paste them into a Word document or secure notes app
* Label them clearly: "LinkedIn Client ID" and "LinkedIn Client Secret"
> **⚠️ IMPORTANT SECURITY NOTE:**
* The Client Secret is like a password - keep it private
* Don't share it publicly or post it anywhere online
* Don't email it to yourself using unsecured email
* You'll share it securely with Artha Support Team in a later step
**You'll know you're in the right place when:** You see a section labeled "Application credentials" with these two values.
***
#### Step 5: Set Up Your Redirect URL
**What you're doing:** Telling LinkedIn where to send users after they successfully log in with LinkedIn.
1. Still on the **"Auth"** tab, scroll down to find **"Authorized redirect URLs for your app"**
2. Click the **"Add redirect URL"** button or the pencil/edit icon
3. Enter your job seeker login page URL in this exact format:
```
https://yourwebsite.com/jobsseekers/login
```
**Important:** Replace "yourwebsite.com" with your actual domain name
**Examples:**
* If your website is jobsphere.com, enter: `https://jobsphere.com/jobsseekers/login`
* If your website is careers.mycompany.com, enter: `https://careers.mycompany.com/jobsseekers/login`
4. Click **"Update"** or **"Save"**
**Why this matters:** After someone logs in with LinkedIn, this tells LinkedIn "send them back to this page on the job portal." It's like giving LinkedIn your return address.
**You'll know it worked when:** Your redirect URL appears in the list of authorized URLs.
***
#### Step 6: Request Access to LinkedIn's Sign-In Feature
**What you're doing:** Asking LinkedIn for permission to use their "Sign in with LinkedIn" feature. This isn't automatic - you need to request it.
1. At the top of your app dashboard, click on the **"Products"** tab
2. Look for a product called **"Sign In with LinkedIn using OpenID Connect"**
* It might also be listed as just "Sign In with LinkedIn"
3. Click the **"Request access"** button next to it
**What happens next:**
* LinkedIn will review your request (usually happens automatically within a few minutes)
* You might receive an email confirmation
* The status should change from "Available" to "Added" or show a checkmark
**You'll know it worked when:** The product shows as "Added" or "Enabled" with a green checkmark, or you receive a confirmation email from LinkedIn.
> **Note:** Sometimes LinkedIn requests additional information or verification. If your request isn't approved immediately, check your email for messages from LinkedIn Developer Support.
***
#### Step 7: Share Information with Artha Support Team
**What you're doing:** Giving the Artha technical team the information they need to connect your job portal's backend to LinkedIn.
> **🚨 CRITICAL: You do NOT need to configure or code anything yourself. The Artha Support Team handles all technical integration.**
**What to send to Artha Support:**
Send an email to Artha Support with the following information:\
\
**Email Address:**
**Email Subject:** LinkedIn Social Login Setup - \[Your Company Name]
**Email Body:**
```
Hello Artha Support Team,
I've completed the LinkedIn Developer setup for social login integration. Please find the required credentials below:
LinkedIn App Name: [Your app name]
Client ID: [Paste your Client ID here]
Client Secret: [Paste your Client Secret here]
Redirect URL: [Your redirect URL, e.g., https://yoursite.com/jobsseekers/login]
Please integrate these credentials into our job portal backend. Let me know when testing can begin.
Thank you,
[Your Name]
[Your Contact Information]
```
**Security Tip:** If your company uses a secure file-sharing system (like a password-protected document), consider using that instead of email for sharing the Client Secret.
***
#### Step 8: Wait for Confirmation from Artha Support
**What you're doing:** Giving the Artha technical team time to configure the backend of your job portal.
**What's happening behind the scenes:**
* The Artha team is adding your LinkedIn credentials to your job portal's configuration
* They're testing the connection between your portal and LinkedIn
* They're making sure the "Sign in with LinkedIn" button appears correctly
* They're verifying that user data flows properly
**Expected timeline:**
* Typically 1-3 business days
* Artha Support will email you when integration is complete
**What you should do:**
* ✅ Wait for confirmation email from Artha Support
* ✅ Don't try to test the login yet - it won't work until backend setup is complete
* ✅ Keep your Client ID and Client Secret safely saved.
**You'll know it's ready when:** You receive an email from Artha Support saying "LinkedIn Social Login integration is complete and ready for testing."
***
#### Step 9: Test Your LinkedIn Login
**What you're doing:** Making sure everything works correctly before your actual job seekers start using it.
Once Artha Support confirms the integration is complete:
1. **Open an incognito/private browser window** (this ensures a clean test)
* Chrome: Press Ctrl+Shift+N (Windows) or Cmd+Shift+N (Mac)
* Firefox: Press Ctrl+Shift+P (Windows) or Cmd+Shift+P (Mac)
* Safari: File menu → New Private Window
2. **Go to your job seeker login page**
* Example: [https://yourwebsite.com/jobsseekers/register](https://yourwebsite.com/jobseekers/register)
3. **Look for the "Sign in with LinkedIn" button**
* It should appear alongside other login options
4. **Click the button and follow the process:**
* You'll be redirected to LinkedIn
* LinkedIn will ask if you want to allow your job portal to access your profile
* Click "Allow" or "Agree"
* You should be redirected back to your job portal, now logged in
5. **Check these things:**
* ✅ Does the login work smoothly?
* ✅ Are you redirected back to the correct page?
* ✅ Does your profile information appear correctly?
* ✅ Is the branding correct (your company name/logo, not Artha's)?
* ✅ Can you log out and log back in successfully?
**Common issues and fixes:**
* **Button doesn't appear:** LinkedIn Social login must be enabled from
* **Error message appears:** Take a screenshot and send it to Artha Support
* **Redirects to wrong page:** Double-check your redirect URL in Step 5
* **Shows Artha branding instead of yours:** Contact Artha Support immediately
***
### Troubleshooting Common Issues
#### "I don't have a LinkedIn Company Page"
**Solution:** Create one first at - it only takes 5 minutes and is required by LinkedIn for social login.
#### "I can't find the 'Create app' button"
**Solution:** Make sure you're logged in and on the "My Apps" page. If you still don't see it, your LinkedIn account may not have permission - try using an administrator account.
#### "My request for Sign In with LinkedIn is pending"
**Solution:** This usually resolves within 24 hours. Check your email for any messages from LinkedIn. If it's been more than 2 days, contact LinkedIn Developer Support.
#### "The login button shows 'Artha' instead of my company name"
**Solution:** Contact Artha Support immediately - there's a branding configuration that needs to be updated on the backend.
#### "Users are getting an error when they click the LinkedIn button"
**Solution:**
* Verify your Redirect URL is correct in LinkedIn Developer Portal
* Contact Artha Support to check backend configuration
* Take a screenshot of the error and share it with Artha Support
#### "I lost my Client Secret"
**Solution:** You can regenerate it in LinkedIn Developer Portal:
1. Go to your app → Auth tab
2. Click "Regenerate" next to Client Secret
3. Copy the new secret immediately
4. Share it with Artha Support to update the backend
***
### Frequently Asked Questions
**Q: Will this cost me anything?** \
A: LinkedIn's basic Sign In feature is **free**. There are no additional charges from LinkedIn for standard social login functionality.
**Q: What information does LinkedIn share with my job portal?** \
A: Typically: name, email address, profile photo, and basic profile information. Users will see exactly what's being shared when they authorize the login.
**Q: Can users still create regular accounts with email/password?** \
A: Yes! LinkedIn login is an additional option, not a replacement. Users can choose their preferred method.
**Q: What if a user doesn't have a LinkedIn account?** \
A: They can use your portal's regular email/password registration. LinkedIn login is optional.
**Q: Is this secure?** \
A: Yes. OAuth (the technology behind "Sign in with LinkedIn") is an industry-standard security protocol used by millions of websites worldwide.
**Q: What happens if LinkedIn changes their policies?** \
A: LinkedIn will email you at the business email you registered. You may need to accept updated terms or make small adjustments, but Artha Support can help with technical changes.
**Q: Can I add Google login too?** \
A: Indeed! Check below 👇
{% content-ref url="connect-your-google-account-for-social-login" %}
[connect-your-google-account-for-social-login](https://docs.arthajobboard.com/guides/connect-your-google-account-for-social-login)
{% endcontent-ref %}
***
### Need Help?
**For LinkedIn Developer Portal issues:**
* LinkedIn Developer Support:
* LinkedIn API Documentation:
**For integration or technical issues:**
* Contact Artha Support Team
* Have your Client ID ready when contacting support (don't share your Client Secret unless using a secure channel)
***
### Quick Checklist - Did You Complete Everything?
Use this checklist to make sure you haven't missed any steps:
* [ ] Created LinkedIn Developer account and logged in
* [ ] Created a new app with all required details
* [ ] Copied and saved Client ID and Client Secret securely
* [ ] Set up the correct Redirect URL
* [ ] Requested access to "Sign In with LinkedIn using OpenID Connect"
* [ ] Received approval/confirmation from LinkedIn (green checkmark or email)
* [ ] Sent credentials to Artha Support Team
* [ ] Received confirmation from Artha Support that integration is complete
* [ ] Tested the login in incognito/private browser mode
* [ ] Verified correct branding (your company, not Artha)
* [ ] Confirmed successful login, profile loading, and logout
**Congratulations!** 🎉 Your job seekers can now log in with LinkedIn!
***
*Last Updated: December 2025* *For questions about this guide, contact your Artha account manager.*
