Event Types & Payloads

We-Link sends different event types through webhooks depending on the API action that was performed. Each event carries a consistent payload structure with type-specific result data.

Event Categories

Authentication Events

Event Type	Trigger	Description
LOGIN_SUCCESS	Account login	Account successfully connected
LOGIN_FAILED	Account login	Login attempt failed
LOGIN_PIN_REQUIRED	Account login	2FA PIN required from user

LOGIN_SUCCESS Payload:

{
  "status": "SUCCESS",
  "request_id": "req-12345",
  "result": {
    "first_name": "Jane",
    "last_name": "Doe",
    "profile_id": "jane-doe-123",
    "public_identifier": "jane-doe-public",
    "premium": true,
    "occupation": "Software Engineer",
    "email": "jane.doe@example.com"
  },
  "hash": "..."
}

LOGIN_PIN_REQUIRED Payload:

{
  "status": "PIN_REQUIRED",
  "request_id": "req-12345",
  "message": "Please provide the verification code sent to the user",
  "hash": "..."
}

Connection Events

Event Type	Trigger	Description
CONNECTION_SENT	Send connection	Invitation successfully sent
CONNECTION_FAILED	Send connection	Invitation failed to send

CONNECTION_SENT Payload:

{
  "status": "SUCCESS",
  "request_id": "req-67890",
  "result": {
    "connected": true,
    "profile_id": "target-user-456"
  },
  "hash": "..."
}

Messaging Events

Event Type	Trigger	Description
MESSAGE_SENT	Send message	Message delivered successfully
MESSAGE_REPLY	Message sync	New reply detected via reply tracking
MESSAGE_FAILED	Send message	Message delivery failed

Profile Events

Event Type	Trigger	Description
PROFILE_VIEWED	View profile	Profile visit completed
PROFILE_DATA	Scrape profile	Profile data retrieved

Search Events

Event Type	Trigger	Description
SEARCH_COMPLETED	Perform search	Search results ready

Common Payload Fields

Every webhook payload contains these standard fields:

Field	Type	Description
status	string	SUCCESS, FAILED, or event-specific status
request_id	string	Unique identifier matching the original API request
result	object	Event-specific result data (on success)
error	string	Error message (on failure)
hash	string	HMAC signature for verification

Error Codes in Payloads

Error Code	Description
WRONG_PASSWORD	Invalid LinkedIn credentials
PROXY_ERROR	Proxy connection failed
ACCOUNT_RESTRICTED	LinkedIn has restricted the account
STATUS_429	LinkedIn rate limit exceeded
PROFILE_NOT_FOUND	Target profile doesn't exist
RECRUITER_ACKNOWLEDGEMENT_REQUIRED	LinkedIn Recruiter session acknowledgement needed