Introduction

LinkupAPI connects your product or AI agent to LinkedIn, WhatsApp, and Email. One unified API to automate outreach, find contacts, and gather market insights for sales and recruitment.

What You Can Build

Sales Automation

Generate leads, automate outreach on LinkedIn/WhatsApp/Email, track funding signals, and enrich company data in real-time.

Recruitment Automation

Source candidates, track hiring companies, and connect with talent on LinkedIn and WhatsApp at scale.

What’s New in V2

Action-Based Endpoints

Each category has a single endpoint. Send the action in the request body instead of calling different URLs.

Account Management

Manage your accounts via the API. List accounts, get details, and use account_id in all requests.

Standardized Responses

Every response follows the same format with success, data/error, and metadata fields.

Quick Start

1. Get Your API Key

2. Connect Your Account

curl -X POST https://api.linkupapi.com/v2/login \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"platform": "linkedin", "login_token": "your_token", "country": "FR"}'

3. Make Your First Request

curl -X POST https://api.linkupapi.com/v2/profiles \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"account_id": "your_account_id", "action": "get_me"}'

Authentication

All V2 endpoints require your API key in the x-api-key header.

Request Format

All action endpoints use POST with the following body structure:

{
  "account_id": "acc_123",
  "action": "action_name",
  "params": {
    "key": "value"
  }
}

string

required

The unique identifier of the account to use for this action.

string

required

The action to perform. Each category has its own set of available actions.

object

Action-specific parameters. See each action’s documentation for required and optional fields.

Response Format

Every V2 response follows a standardized format.

Success Response

{
  "success": true,
  "data": {
    "..."
  },
  "metadata": {
    "action": "get_profile",
    "account_id": "acc_123",
    "credits_consumed": 1,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

Error Response

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Missing required parameter: profile_url"
  },
  "metadata": {
    "action": "get_profile",
    "credits_consumed": 0,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

Billing

Two billing modes, chosen in Billing. The API is identical, only the limits differ. Per-account plan. You pay per connected account (one LinkedIn profile, mailbox or WhatsApp number), billed upfront each month: $55 for the first 10 accounts, then $5.50 per extra account, capped at $3,000/month. Usage is unlimited on every endpoint. With auto-upgrade on (default) you can connect beyond your seats and the monthly peak is billed at renewal; with it off, one account too many returns SEAT_LIMIT_REACHED. Only email enrichment still consumes credits. Credit plans. Most actions consume 1 credit per request. Actions that return lists (search, get connections, etc.) consume 1 credit per 10 results, rounded up. For example:

Fetching a single profile: 1 credit
Searching with 25 results: 3 credits (25 / 10 = 2.5, rounded up to 3)
Listing 10 connections: 1 credit

The exact number of credits consumed is always returned in the metadata.credits_consumed field of the response. At zero, calls return INSUFFICIENT_CREDITS until the plan renews or you buy a pack.

Available Categories

Category	Endpoint	Description
Profiles	`POST /v2/profiles`	Get profile info, search profiles, visit profiles, get contact info
Messages	`POST /v2/messages`	Send messages, get conversations, list inbox
Network	`POST /v2/network`	Send connection requests, manage invitations, get connections
Content	`POST /v2/content`	Create posts, comment, like, repost, get feed
Recruiter	`POST /v2/recruiter`	Create job posts, get candidates, manage job offers
Credits	`GET /v2/credits`	Check your credit balance
Webhooks	`POST/GET /v2/webhooks`	Real-time event notifications via webhook URLs
Mail	`POST /v2/mail`	Find, reverse-lookup, and validate email addresses

Need Help?

Check our Migration Guide if you’re coming from V1
Email: [email protected]

Getting Started

Accounts

Profiles

Messaging

Network

Content

Recruiting

Credits

Logs

Email Enrichment

Webhooks (Real-Time)

What You Can Build

Sales Automation

Recruitment Automation

What’s New in V2

Action-Based Endpoints

Account Management

Standardized Responses

Quick Start

1. Get Your API Key

2. Connect Your Account

3. Make Your First Request

Authentication

Request Format

Response Format

Success Response

Error Response

Billing

Available Categories

Need Help?

​What You Can Build

Sales Automation

Recruitment Automation

​What’s New in V2

Action-Based Endpoints

Account Management

Standardized Responses

​Quick Start

​1. Get Your API Key

​2. Connect Your Account

​3. Make Your First Request

​Authentication

​Request Format

​Response Format

​Success Response

​Error Response

​Billing

​Available Categories

​Need Help?

What You Can Build

What’s New in V2

Quick Start

1. Get Your API Key

2. Connect Your Account

3. Make Your First Request

Authentication

Request Format

Response Format

Success Response

Error Response

Billing

Available Categories

Need Help?