Facebook Pixel
APILinkedIn Account

LinkedIn Account API

Manage LinkedIn account status via API. Monitor account health, track activity history, and check warmup status for safe automation.

LinkedIn Account API

Manage your LinkedIn account status, view activity history, and monitor warmup progress. These endpoints help you ensure account health and track engagement activity before performing automated actions.

Capabilities

  • Account Status: Check health and connectivity of your LinkedIn accounts
  • Activity History: View paginated history of all actions performed
  • Warmup Tracking: Monitor warmup progress for new accounts to avoid restrictions

Endpoints

Click on any endpoint below to view detailed documentation, parameters, example requests, and try it live.

Get Account Status →

GET /account/status

Check the current status of your default LinkedIn account. Returns connection health, warmup stage, and any active restrictions.


Get Account Status by ID →

GET /account/{accountId}/status

Check the status of a specific LinkedIn account by its ID. Useful when managing multiple accounts.


Get Account Activity →

GET /account/{accountId}/activity

Retrieve paginated activity history for a specific account. View all actions performed including messages sent, connections made, and posts engaged with.


Get Warmup Status →

GET /account/{accountId}/warmup

Check the warmup progress of an account. New accounts need gradual activity increases to avoid LinkedIn restrictions.


Refresh Warmup Status →

POST /account/{accountId}/warmup/refresh

Force a refresh of the warmup status cache. Use this after significant activity changes.


Use Cases

Sales Teams

Monitor multiple team member accounts to ensure they maintain healthy status for outreach campaigns. Track activity across the organization and ensure compliance with LinkedIn's usage guidelines.

Marketing Automation

Verify account health before scheduling automated engagement campaigns. Check warmup status to determine safe activity volumes for new accounts.

Recruitment Agencies

Manage recruiter accounts and track their LinkedIn activity. Ensure accounts are properly warmed up before high-volume candidate sourcing.

Enterprise Compliance

Audit LinkedIn activity across your organization. Track what actions were performed, when, and by which accounts for compliance reporting.

Best Practices

  1. Check status before automation: Always verify account health before running automated campaigns
  2. Monitor warmup progress: New accounts should gradually increase activity over 2-4 weeks
  3. Track activity patterns: Review activity history to identify unusual patterns
  4. Handle restrictions gracefully: If an account shows restrictions, pause automation and investigate

Quick Start

// Check account status before starting a campaign
const status = await fetch('https://api.connectsafely.ai/linkedin/account/status', {
  headers: { 'Authorization': `Bearer ${API_KEY}` }
});

const data = await status.json();

if (data.status === 'healthy' && data.warmupStage === 'complete') {
  // Safe to run full automation
  console.log('Account ready for automation');
} else if (data.warmupStage === 'in_progress') {
  // Reduce activity volume
  console.log('Account warming up - use reduced volumes');
}

No-Code Alternatives

Prefer visual automation? Monitor accounts through integrations: