Creating & Managing Webhooks
Webhooks are the essential bridge that delivers data — such as successful connections, profile scrapes, or incoming messages — back to your system in real-time.
Creating a Webhook
Configure webhooks directly in the We-Link dashboard:
1. Navigate to Webhooks
Log in to your We-Link Dashboard and go to the Webhooks section.
2. Define the Endpoint
Enter the URL on your server set up to receive POST requests:
https://api.yoursite.com/events/welink
3. Assign a Name & Description
| Field | Example | Required |
|---|---|---|
| Name | Production Listener | Yes |
| Description | Main webhook for auth and messaging events | Optional |
4. Set the Secret Code
Create a custom Secret Code. This is a critical security credential used to sign every payload, allowing you to verify authenticity.
5. Select Triggers
Choose which events trigger a notification. You can granularly enable or disable individual triggers from the list below.
Create separate webhooks for different event types. For example, one for Authentication events and another for Messaging events. This keeps your server handlers focused and maintainable.
5. Test and save
Once you’ve configured your settings and selected the appropriate triggers, click ‘Test’ to ensure your endpoint is responding correctly. If successful, hit ‘Save’ to activate the webhook.
Available Triggers
Below is the complete list of webhook triggers. Each trigger corresponds to an API endpoint or system event that delivers results to your webhook URL.
Authentication
| Trigger | Description |
|---|---|
| Login | Login to LinkedIn account |
| Login v2 | Login to LinkedIn account (v2) |
| Login code | Submit login verification code |
| Login PIN Required | PIN or 2FA verification required during login |
Profile & Account
| Trigger | Description |
|---|---|
| Profile | Get own profile data |
| View Profile | View a profile on LinkedIn |
| Get Profile Details | Retrieve details of a profile |
| Get Profile Contact Details | Get contact details of a profile |
| Get Badges | Get badges of a profile |
| Linked in account status changes | LinkedIn account status change notification |
| Get LinkedIn Account Details | Get LinkedIn account details |
| Get All LinkedIn Accounts | Get all LinkedIn accounts |
| Delete Account | Delete a LinkedIn account |
Connections & Network
| Trigger | Description |
|---|---|
| Profile Views | Get profile views |
| Profile Connections | Get profile connections |
| Profile Pending Invites | Get pending invites |
| Connect | Send a connection request |
| Withdraw Invite | Withdraw a connection invite |
| Disconnect | Disconnect from a profile |
| Get connection status | Retrieve connection status |
Birthdays / Anniversaries / Job Changes
| Trigger | Description |
|---|---|
| Get Birthdays | Retrieve birthdays |
| Get Work Anniversaries | Retrieve work anniversaries |
| Get job changes | Retrieve job changes |
| Wish Birthdays | Send birthday wishes (batch) |
| Wish Job Changes | Send job change wishes (batch) |
| Wish Work Anniversaries | Send work anniversary wishes (batch) |
| Wish Birthday | Wish a specific user happy birthday |
| Wish Job Change | Wish a specific user on job change |
| Wish Work Anniversary | Wish a specific user on work anniversary |
Messaging (Regular LinkedIn)
| Trigger | Description |
|---|---|
| Personal Message Threads | Get personal message threads |
| Personal Messages | Get personal messages |
| Send Message to Thread | Send a message to a thread |
| Send Message to Profile ID | Send a message to a profile by ID |
| Send Message to Group Member | Send a message to a group member |
| Send Message to Event Member | Send a message to an event member |
| Send InMail Message | Send an InMail message to a profile |
| Get Response | Get a response from a user |
| Message reply tracking | Track reply for a message sent on LinkedIn |
| Get active message tracker | Get active message tracker |
| Update active message tracker | Update active message tracker |
Sales Navigator
| Trigger | Description |
|---|---|
| Sales Message Threads | Get Sales Navigator message threads |
| Sales Messages | Get Sales Navigator messages |
| Send Message to Profile ID | Send a message to a Sales Navigator profile by ID |
| Send Message to Thread ID | Send a message to a Sales Navigator thread by ID |
| Sales Nav Regular Search | Perform Sales Navigator regular search |
| Sales Nav Recent Search | Perform Sales Navigator recent search |
| Sales Nav Saved Search | Perform Sales Navigator saved search |
| Sales Nav Lead List Search | Perform Sales Navigator lead list search |
| Sales Nav History Search | Perform Sales Navigator history search |
| Convert Sales Navigator ID | Convert a Sales Navigator ID to a LinkedIn profile URL |
Recruiter
| Trigger | Description |
|---|---|
| Recruiter Saved Search | Perform recruiter saved search |
| Recruiter History Search | Perform recruiter history search |
| Recruiter Project Search | Perform recruiter project search |
| Recruiter contracts | Fetch recruiter contracts |
| Recruiter me | Get own recruiter profile data |
| Recruiter message threads | Fetch recruiter message threads |
| Recruiter Messages | Get recruiter messages |
| Send message to recruiter thread id | Send message to a recruiter thread |
| Send recruiter messages | Send messages to profile ID from recruiter |
Search
| Trigger | Description |
|---|---|
| Regular Search | Perform regular LinkedIn search |
| Group Search | Perform group search |
| Post Search | Perform LinkedIn post search |
| Event Search | Perform event search |
Posts & Engagement
| Trigger | Description |
|---|---|
| Create Post | Create a post on LinkedIn |
| Get Posts | Get posts from a LinkedIn account |
| Like a Post | Like a post |
| Follow | Follow a profile |
| Unfollow | Unfollow a profile |
| Endorse | Endorse a skill or profile |
Companies, Groups & Events
| Trigger | Description |
|---|---|
| Get Companies | Get list of companies |
| Get company details | Retrieve company details |
| Get Groups | Get list of groups |
| Events | Get events |
| Event Invite | Send an event invite |
| Withdraw Event Invite | Withdraw an event invite |
| Follow Company Invite | Invite to follow a company |
| Withdraw Follow Company Invite | Withdraw a company follow invite |
| Company usage | Retrieve company subscription consumption |
Files
| Trigger | Description |
|---|---|
| Upload File | Upload a file to LinkedIn |
| File Info | Get information about a file |
| Files | Get list of files |
Proxy & System
| Trigger | Description |
|---|---|
| Rotate Internal Proxy | Rotate the internal proxy for an account |
| Switch to Internal | Switch to internal proxy |
| Switch to Customer | Switch to customer proxy |
| Proxy Status | Reactivate status of the proxy |
| Get active subscription | Fetch active LinkedIn subscriptions |
Managing Webhooks
Filtering via Triggers
You don't need to listen to every single event. Disable irrelevant triggers to reduce noise and save bandwidth on your server.
Monitoring Status
If you need to debug or check if a specific action triggered a webhook, use the response endpoint:
POST /api/v1/get_response
{
"requestId": "req-12345-abcde"
}
This allows you to manually check the status of a task if your webhook handler misses an event.