Documentation

Searching for Leads

Use the Leads page to search LinkedIn. Enter keywords and apply filters for job title, location, and industry. Results show each person's name, headline, company, location, and current connection status (connected, pending, or not connected).

Saving to Lists

Select one or more leads using the checkboxes, then click Save to List. You can create new lists or add to existing ones. Leads can belong to multiple lists simultaneously, so you can organize by campaign, industry, priority, or any other criteria.

Importing Leads

Go to the Import page to add leads by LinkedIn profile URL. Paste one URL per line. LinkAngler fetches the profile data from LinkedIn and adds each person to your leads.

Lead Profiles

Click on any lead to view their full profile. The profile page shows their headline, company, location, and connection status. You will also see their engagement history (messages sent, connection requests), which campaigns they are enrolled in, and which lists they belong to.

Step Types

• Send Connection -- Sends a LinkedIn connection request. Optionally include a personalized message.
• Send Message -- Sends a direct message. The lead must already be a connection.
• Like Post -- Likes the lead's most recent LinkedIn post to increase visibility before outreach.
• AI Comment -- AI generates and posts a relevant comment on the lead's most recent post using an AI Persona you select.
• Voice Note -- Sends an AI-generated voice message with a personalized greeting (the lead's name via text-to-speech) spliced onto a pre-recorded voice template. Requires ElevenLabs setup.

Personalization Variables

Use these variables in connection requests and messages. They are automatically replaced with each lead's data:

• {firstName} -- Lead's first name
• {company} -- Lead's company name
• {headline} -- Lead's LinkedIn headline

If a variable cannot be resolved (e.g., no company listed), LinkAngler uses an automatic fallback so the message still reads naturally.

Campaign Lifecycle

Campaigns move through these statuses: Draft (building steps) → Active (executing actions) → Paused (temporarily stopped) → Completed (all enrollees finished). You can pause and resume at any time.

Daily Limits by LinkedIn Account Tier

LinkAngler automatically detects your LinkedIn account tier and applies the correct daily limits. Premium LinkedIn accounts get higher daily limits.

Safety Features

• Quiet hours -- No actions are sent during off-hours to mimic natural usage patterns
• Warm-up period -- New campaigns start with lower daily limits that gradually increase over time
• Rate limiting -- Daily limits are enforced across all campaigns combined, not per campaign

Best Practices

• Personalize every connection request -- generic messages have much lower acceptance rates
• Wait 3-5 days between campaign steps to appear natural
• Keep initial messages under 300 characters for higher response rates
• Use AI Personas for post comments to ensure authentic, relevant engagement

What is an ICP?

An Ideal Customer Profile (ICP) defines the characteristics of your best-fit prospects. Instead of searching manually, LinkAngler uses your ICP to generate targeted LinkedIn searches and score results automatically.

Creating ICP Profiles

Go to Discovery → ICP Profiles and create a new profile. Define your target criteria:

• Target titles -- Job titles your prospects typically hold (e.g., VP of Sales, Head of Marketing)
• Industries -- Target industries (e.g., SaaS, Financial Services)
• Seniority levels -- Manager, Director, VP, C-Suite, etc.
• Locations -- Geographic targets (e.g., San Francisco, United Kingdom)
• Company sizes -- Employee count ranges (e.g., 51-200, 1001-5000)
• Keywords -- Terms that should appear in profiles (e.g., B2B, enterprise sales)

AI Lead Analysis

If you have 20 or more saved leads, the Analyze My Leads button appears on the ICP page. AI examines your existing lead data and suggests values for each ICP field based on patterns it finds. This helps you create a data-driven ICP rather than guessing.

Search Generation & Execution

Once your ICP is configured, AI generates LinkedIn search queries tailored to your criteria. You review and approve each search before it runs. Approved searches execute automatically via background automation (every 30 minutes) and results are scored against your ICP.

Lead Scoring

Each discovered lead receives a score from 0 to 100 based on how well they match your ICP. The score breaks down as follows:

• Title match -- 30% weight
• Industry -- 20% weight
• Seniority -- 20% weight
• Location -- 15% weight
• Keywords -- 15% weight

Score colors:

• Green (80+) -- Strong match
• Blue (60-79) -- Good match
• Yellow (40-59) -- Moderate match
• Gray (below 40) -- Weak match

Auto-Save & Auto-Enroll

Configure a score threshold to automatically save high-scoring leads to a designated list. You can also enable auto-enroll to automatically add qualifying leads into an active campaign, creating a fully automated prospecting pipeline.

Discovery Limits

LinkAngler processes up to 50 search pages per day per user. Discovery searches run automatically every 30 minutes via background automation.

AI Provider Setup

Go to Settings → AI Provider. Enter your API key and base URL from your chosen provider. We recommend OpenRouter (openrouter.ai) for the widest model compatibility. Select a model name -- larger models generally produce better ICP analysis, search queries, and post comments.

AI Personas

AI Personas are reusable personality profiles for generating LinkedIn post comments. Each persona has a name, description, and tone (e.g., "Thoughtful Industry Expert" or "Friendly Connector"). Create personas in Settings → AI Personas and assign them to AI Comment steps in your campaigns. The persona guides the AI to generate comments that sound authentic and match your desired voice.

Voice Notes

Voice notes require an ElevenLabs account (elevenlabs.io). Set up your ElevenLabs API key in Settings → Voice, then upload a voice template (a short audio clip of your voice). When a Voice Note step executes, LinkAngler generates a personalized greeting (the lead's name via text-to-speech) and splices it onto your pre-recorded template. You can preview the result before activating the campaign.

AI Help Assistant

Click the "Ask" button in the header to open the AI Help Assistant. It knows your current app setup (LinkedIn connection status, campaigns, ICP profiles) and provides contextual help, troubleshooting, and guidance. Conversations are saved and persist for 30 days. You can also escalate to human support or provide feedback directly from the chat.