Send a Connection Request in LinkedIn

POST /api/v1/connect

This API allows the authenticated user to send a connection request to another LinkedIn user, initiating a potential professional relationship.

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.

You can optionally include a message parameter to personalize the connection request with a note. If provided, this message will be sent along with the request on LinkedIn.

Important

LinkedIn applies account-specific character limits, which typically range between 200–300 characters.

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.

messagestringThe content of the message to be sent.

Sample Request

{
  "accountId": "string",
  "profile_id": "string",
  "message": "string"
}

Responses

Webhook Events

Schema

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

requestIdstringUnique identifier for the request.

resultobjectThe response payload.

connectedbooleanWhether the connection was established.

profile_idstringrequiredThe unique identifier of the LinkedIn profile.

Sample Response

{
  "status": "string",
  "requestId": "string",
  "result": {
    "connected": false,
    "profile_id": "string"
  }
}