Get received invitations

Retrieves received invitations from LinkedIn including connection requests, organization follow invites, and newsletter subscriptions. Returns invitation details with category classification (CONNECTION, ORGANIZATION, NEWSLETTER, EVENT, MEMBER_FOLLOW). Supports pagination via startIndex parameter.

GET/invitations/received

Authentication requiredUser

Code Examples

curl -X GET 'https://api.connectsafely.ai/linkedin/invitations/received' \
  -H 'Authorization: Bearer <your_api_key>'

Parameters

Name	In	Required	Type	Description
`accountId`	query	No	string	LinkedIn account ID to use. If not provided, uses the default account.
`startIndex`	query	No	number	Pagination start index (0-indexed). Each page returns 10 invitations.

Request Body

No request body.

Responses

Status	Description
200	Received invitations retrieved successfully
401	Unauthorized - invalid or missing authentication
500	Server error while fetching received invitations

200 Response Parameters

Name	Type	Description
`success`	boolean
`invitations`	array
`count`	number	Number of invitations returned
`startIndex`	number	Current pagination start index
`accountId`	string	LinkedIn account ID used

200 Example

{
  "success": true,
  "invitations": [
    {
      "id": "7455891636745551899",
      "invitationId": "7455891636745551899",
      "invitationUrn": "urn:li:invitation:7455891636745551899",
      "memberId": "",
      "memberUrn": "",
      "invitationType": "RECEIVED",
      "invitationCategory": "ORGANIZATION",
      "linkedInInvitationType": "GenericInvitationType_ORGANIZATION",
      "validationToken": "C712w50Z",
      "receivedAt": "2 weeks ago",
      "companyName": "ZenX8Studio",
      "profile": {
        "firstName": "Yash",
        "lastName": "Jadhav",
        "profileUrl": "https://www.linkedin.com/in/yash-jadhav-a03656326/",
        "publicIdentifier": "yash-jadhav-a03656326"
      }
    },
    {
      "id": "7455163451166860117",
      "invitationId": "7455163451166860117",
      "invitationUrn": "urn:li:invitation:7455163451166860117",
      "memberId": "",
      "memberUrn": "",
      "invitationType": "RECEIVED",
      "invitationCategory": "NEWSLETTER",
      "linkedInInvitationType": "GenericInvitationType_ORGANIZATION",
      "validationToken": "EJx1vfKg",
      "receivedAt": "2 weeks ago",
      "newsletterName": "VAYUZ Insights",
      "profile": {
        "firstName": "Natalya",
        "lastName": "Singh",
        "profileUrl": "",
        "publicIdentifier": ""
      }
    },
    {
      "id": "7455301624689844224",
      "invitationId": "7455301624689844224",
      "invitationUrn": "urn:li:invitation:7455301624689844224",
      "memberId": "ACoAAAYHg8oBNy-PmYu4ZIXcv5yOcNldwpl8lj8",
      "memberUrn": "urn:li:fsd_profile:ACoAAAYHg8oBNy-PmYu4ZIXcv5yOcNldwpl8lj8",
      "invitationType": "RECEIVED",
      "invitationCategory": "CONNECTION",
      "linkedInInvitationType": "GenericInvitationType_CONNECTION",
      "validationToken": "jywembME",
      "receivedAt": "2 weeks ago",
      "profile": {
        "firstName": "Deepika",
        "lastName": "Khare",
        "profileUrl": "https://www.linkedin.com/in/deepika-khare/",
        "publicIdentifier": "deepika-khare"
      }
    }
  ],
  "count": 10,
  "startIndex": 0,
  "accountId": "69da1eacf365891afa0426a4"
}

401 Response Parameters

Name	Type	Description
`error`	string

401 Example

{
  "error": "example_value"
}

500 Response Parameters

Name	Type	Description
`error`	string

500 Example

{
  "error": "example_value"
}

Code Examples

On this page