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
- Check status before automation: Always verify account health before running automated campaigns
- Monitor warmup progress: New accounts should gradually increase activity over 2-4 weeks
- Track activity patterns: Review activity history to identify unusual patterns
- 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');
}Related API Categories
- LinkedIn Actions - Send messages, connect, and follow
- LinkedIn Analytics - Track engagement metrics
- LinkedIn Messaging - Advanced messaging features
No-Code Alternatives
Prefer visual automation? Monitor accounts through integrations:
API Overview
Complete guide to the ConnectSafely API including authentication, rate limits, error handling, and endpoint groups for LinkedIn automation and data retrieval.
Get account status
Retrieve the current status of the default LinkedIn account for the authenticated user. Returns account health, enabled state, and last activity timestamp. Use this to verify account connectivity before performing actions.
