Send Message to Profile

This API enables the authenticated user to send a direct message to a specific LinkedIn profile by providing the recipient's profile ID, the sender's own profile ID, and the message content.

The profile_id is a unique identifier used by LinkedIn to distinguish individual user profiles. On WeLink, you can obtain the profile_id by calling the /api/v1/get_profile_details API. In the response of this API, the field profile_id is provided. This value should be used as the profile_id when making requests to other WeLink APIs that require a LinkedIn profile reference.

To track whether your message receives a reply, see How to Use Track Reply.

POST /api/v1/send_message_to_profile_id

This API enables the authenticated user to send a direct message to a specific LinkedIn profile by providing the recipient's profile ID, the sender's own profile ID, and the message content.

The profile_id is a unique identifier used by LinkedIn to distinguish individual user profiles. On WeLink, you can obtain the profile_id by calling the /api/v1/get_profile_details API. In the response of this API, the field profile_id is provided. This value should be used as the profile_id when making requests to other WeLink APIs that require a LinkedIn profile reference.

To track whether your message receives a reply, see How to Use Track Reply.

Headers

Name	Type	Required
x-api-key	string	Yes
x-api-secret	string	Yes

Request Body

Schema

accountIdstringrequiredThe unique identifier of the WeLink account.

profile_idstringrequiredThe unique identifier of the LinkedIn profile.

messagestringrequiredThe content of the message to be sent.

frequencynumberFrequency of tracking reply for this message (in hours).

track_replybooleanBoolean to enable reply tracking for this message.

Sample Request

{
  "accountId": "string",
  "profile_id": "string",
  "message": "string",
  "frequency": 0,
  "track_reply": false
}

Responses

Webhook Events

Schema

thread_idstringThe unique identifier of the message thread.

message_idstringrequiredThe unique identifier of the sent message.

sent_atnumberTimestamp when the message was sent.

Sample Response

{
  "thread_id": "string",
  "message_id": "string",
  "sent_at": 0
}

POST /api/v1/send_message_to_sales_navigator_profile

This API allows the authenticated user to send a message to a specific LinkedIn Sales Navigator profile by providing the recipient's profile ID, the message content, and the subject of the message. The sales_profile_id parameter should be the LinkedIn Sales Navigator profile ID.

To track whether your message receives a reply, see How to Use Track Reply.

Headers

Name	Type	Required
x-api-key	string	Yes
x-api-secret	string	Yes

Request Body

Schema

accountIdstringrequiredThe unique identifier of the WeLink account.

sales_profile_idstringrequiredThe unique Sales Navigator profile identifier.

messagestringrequiredThe content of the message to be sent.

subjectstringrequiredThe subject line of the message (if applicable).

frequencynumberFrequency of tracking reply for this message (in hours).

track_replybooleanBoolean to enable reply tracking for this message.

Sample Request

{
  "accountId": "string",
  "sales_profile_id": "string",
  "message": "string",
  "subject": "string",
  "frequency": 0,
  "track_reply": false
}

Responses

Webhook Events

Schema

thread_idstringThe unique identifier of the message thread.

message_idstringrequiredThe unique identifier of the sent message.

sent_atnumberTimestamp when the message was sent.

Sample Response

{
  "thread_id": "string",
  "message_id": "string",
  "sent_at": 0
}

POST /api/v1/recruiter_send_message_to_profile_id

This API enables the authenticated user to send a direct message to a specific LinkedIn profile from a recruiter linkedin account by providing the recipient's profile ID, the sender's own profile ID, and the message content.

It acts as a conversation starter and a one-time message request. Once initiated, all subsequent interactions must use the returned thread_id. The recipient can either accept by replying or decline the request; if declined, the sender is restricted from further messaging. However, if the recipient later initiates a message to the sender, the conversation is unlocked, and the sender's ability to reply is restored.

Note

LinkedIn doesn't allow two concurrent sessions on a recruiter plan.

contract_id can be obtained by calling the /api/v1/recruiter_contracts endpoint and extracting the contract_id from the response.

Headers

Name	Type	Required
x-api-key	string	Yes
x-api-secret	string	Yes

Request Body

Schema

accountIdstringrequiredThe unique identifier of the WeLink account.

contract_idstringrequiredThe contract identifier for Recruiter accounts.

profile_idstringrequiredThe unique identifier of the LinkedIn profile.

messagestringrequiredThe content of the message to be sent.

signaturestringrequiredCustom signature to append to messages.

subjectstringrequiredThe subject line of the message (if applicable).

Sample Request

{
  "accountId": "string",
  "contract_id": "string",
  "profile_id": "string",
  "message": "string",
  "signature": "string",
  "subject": "string"
}

Responses

Webhook Events

Schema

statusstringStatus indicating the request completed successfully (e.g. "SUCCESS").

resultobjectThe response payload.

messagestringA descriptive message.

thread_idstringThe unique identifier of the message thread.

Sample Response

{
  "status": "string",
  "result": {
    "message": "string",
    "thread_id": "string"
  }
}