Skip to main content

How to Connect Your LinkedIn Company Page to PyjamaHR (Including Free & Recruiter Lite Accounts)

Updated over a week ago

Executive Summary

Connecting your LinkedIn company page to PyjamaHR allows you to publish jobs directly to LinkedIn, streamline your hiring workflow, and attract more candidates—all from within your ATS. This guide covers the exact steps, requirements, and troubleshooting for integrating your LinkedIn company page (including free and Recruiter Lite accounts) with PyjamaHR, based on real customer scenarios and the latest LinkedIn policies.

Detailed Overview

What is LinkedIn Company Page Integration?
PyjamaHR’s LinkedIn integration lets you post jobs from your ATS directly to your company’s LinkedIn page, making it easier to reach a wider talent pool and manage applicants in one place. This integration supports both free LinkedIn company pages and accounts with Recruiter Lite, but there are important limitations and requirements set by LinkedIn.

When and Why Use This Integration?
- To automate job postings to LinkedIn and save manual effort.
- To ensure all applicants from LinkedIn are tracked in PyjamaHR.
- To maintain a consistent employer brand across platforms.

Integration with Other PyjamaHR Features:
- Job publishing workflow
- Applicant source tracking (e.g., source=LINKEDIN)
- Candidate pipeline management

Business Impact:
- Faster time-to-hire by reaching more candidates
- Reduced manual posting errors
- Centralized candidate management

Step-by-Step Guide: Connecting Your LinkedIn Company Page

Prerequisites & Requirements

  • You must be an admin of the LinkedIn company page you want to connect.

  • The LinkedIn page must be verified and not newly created (see “Common Issues” below).

  • The LinkedIn company name and your PyjamaHR company profile must match, or you must provide legal documentation if using a parent/brand company page.

  • For staffing agencies: LinkedIn has imposed restrictions on free job postings (see “Special Scenarios”).

  • Recruiter Lite users: Direct integration is not supported for advanced Recruiter features, but job posting via company page is available.

1. Gather Your LinkedIn Company Page URL

  • Go to your LinkedIn company page (e.g., https://www.linkedin.com/company/your-company-name/).

  • Copy the public URL (not the admin dashboard link).

2. Start the Integration in PyjamaHR

  1. Log in to PyjamaHR as a Super Admin or user with integration permissions.

  2. Navigate to Settings > Integrations > LinkedIn.

  3. Click ‘Connect’.

  4. Paste your LinkedIn company page URL in the Support chat and wait for the team to reply back.

3. Verification & Approval

  • PyjamaHR will verify the LinkedIn page:

  • If the company name matches, integration is usually instant (10-15 minutes).

  • If there’s a mismatch (e.g., using a parent company or brand), you’ll be asked to provide legal documentation (e.g., GST certificate, business registration, or proof of brand relationship).

4. Publishing Jobs to LinkedIn

  1. Go to the Job Card for the role you want to publish.

  2. Click the three dots (‘...’) > Publish.

  3. In the LinkedIn section, click ‘Publish’.

  4. Your job will be submitted to LinkedIn for review.
    - LinkedIn may take up to 48 hours to review and publish the job.
    - You can track the status in PyjamaHR under the job’s publishing history.

5. Confirm Job Posting

  • Once approved, your job will appear on your LinkedIn company page under ‘Jobs’.

  • Applicants will be redirected to apply via your PyjamaHR job link.

Advanced Usage & Best Practices

Power User Tips

  • Republishing Jobs: If you update a job, republish to LinkedIn to refresh the posting.

  • Applicant Source Tracking: Use the source=LINKEDIN parameter to track applicants from LinkedIn in your reports.

  • Multiple Company Pages: Only integrate pages you own/administer. For brands/parent companies, provide legal proof.

Optimization Strategies

  • Job Details: Ensure job titles, descriptions, and locations are clear and match LinkedIn’s guidelines to avoid rejection.

  • Avoiding Spam Flags: Don’t repost identical jobs rapidly; LinkedIn may flag your account.

  • For Staffing Agencies: Consider integrating client company pages if permitted, but always provide documentation.

Do’s and Don’ts

Do:
- Use the official LinkedIn company page URL.
- Wait for LinkedIn’s review (up to 48 hours).
- Provide documentation if using a parent/brand page.

Don’t:
- Attempt to integrate pages you don’t own/admin (can trigger fraud/spam flags).
- Use newly created LinkedIn pages (integration may be blocked).
- Expect instant job posting—LinkedIn reviews all jobs.

Troubleshooting & Common Issues

Common Error Messages & Solutions

Error Message / Scenario

Solution

“Unable to publish job to LinkedIn. Please contact support.”

Wait 10-15 minutes after integration. If still not working, check if your LinkedIn page is newly created or unverified.

“Job not visible on LinkedIn after publishing”

LinkedIn can take up to 48 hours to review. Check job status in PyjamaHR.

“Integration failed: Company name mismatch”

Provide legal documentation showing relationship (e.g., parent/brand).

“LinkedIn flagged your job as spam”

Avoid rapid reposting, ensure job details are complete and unique. Contact LinkedIn support if flagged.

“Staffing agency restrictions”

LinkedIn may limit free postings for staffing agencies. Consider client page integration or contact LinkedIn for paid options.

“Newly registered LinkedIn account cannot be integrated”

Use only established, verified LinkedIn pages. Wait until LinkedIn verifies your page.

What If Scenarios

  • What if my job is still not live after 48 hours?

  • Contact LinkedIn support via LinkedIn Help and mention you are not a hiring agency if applicable.

  • What if I need to change the LinkedIn page?

  • Disconnect the current page in PyjamaHR settings and repeat the integration steps with the new page.

  • What if I receive a cap on free job postings?

  • LinkedIn may impose limits. Contact your LinkedIn Account Director for paid job slots or wait for the cap to reset.

Comprehensive FAQs

1. Can I connect any LinkedIn company page to PyjamaHR?
No. You must be an admin, and the page must match your PyjamaHR company profile or have legal documentation for parent/brand relationships.

2. How long does it take for jobs to appear on LinkedIn?
Up to 48 hours, as LinkedIn reviews each job before publishing.

3. Can I use a newly created LinkedIn page?
No. LinkedIn blocks integration with newly registered/unverified pages.

4. What if I’m a staffing agency?
LinkedIn restricts free job postings for staffing agencies. You may need to use client company pages (with permission/documentation) or consider paid job slots.

5. Is Recruiter Lite supported?
You can post jobs via your company page, but advanced Recruiter Lite features (like direct ATS integration) are not supported.

6. What documentation is accepted for company verification?
GST certificate, business registration, or legal proof of brand/parent relationship.

7. Can I integrate multiple LinkedIn pages?
Only one page per PyjamaHR account. For multiple brands, provide documentation for each.

8. Why was my account blocked after integration?
If you attempt to integrate a page you don’t own/admin, or if your company details are suspicious, PyjamaHR’s anti-spam filters may block your account. Provide valid documentation to resolve.

9. My job is marked as spam on LinkedIn. What should I do?
Contact LinkedIn support and review your job details for compliance.

10. Can I track applicants from LinkedIn in PyjamaHR?
Yes. All applicants who apply via LinkedIn will appear in the Applied pipeline of the respective job.

11. What if my integration says “Job posted 0 of 3”?
This may be a LinkedIn-imposed cap or a temporary bug. You can usually still post jobs—contact support if you’re blocked.

12. Can I use the same PyjamaHR account to try different LinkedIn pages?
Yes, but only if you have admin access and provide documentation if required.

Related Features & Next Steps

Summary Table: Key Do’s & Don’ts

Do

Don’t

Use verified, established LinkedIn pages

Use newly created or unverified pages

Provide legal documentation for parent/brand pages

Attempt to integrate pages you don’t own/admin

Wait up to 48 hours for LinkedIn review

Expect instant job posting

Contact LinkedIn support for posting issues

Repost identical jobs rapidly (may trigger spam flags)

Still Need Help?

If you’ve followed all steps and your jobs are still not posting, or if your account is blocked, please contact PyjamaHR support with:
- Your LinkedIn company page URL
- Screenshots of errors
- Any legal documentation (if requested)

We’re here to help you get the most out of your LinkedIn integration!

Article last updated: June 2024
​Based on real customer experiences and the latest LinkedIn and PyjamaHR policies.

Did this answer your question?