Detecting Accepted Invitations

You can monitor acceptance through 3 methods:

Webhook: "New relation"

We provide a webhook to track new connections, including accepted invitations (with or without a note) and users accepted via linked accounts.

Please note that this webhook is not real-time, as LinkedIn does not support real-time events for this action. The webhook event may be triggered up to 8 hours after the relation is accepted.

You can create this webhook using the API. The webhook is called "USERS WEBHOOK", and the event type is "new_relation" (included by default in the USERS webhook): Create Webhook

curl --request POST \
  --url https://apiX.unipile.com:XXXX/api/v1/webhooks \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: XXXXX' \
  --data '{
  "source": "users",
  "request_url": "https://yourendpoint",
  "name": "New relation",
	"headers": [
    {
      "key": "Content-Type",
      "value": "application/json"
    }
  ]
}'

{
  "event":"new_relation",
  "account_id":"SDF4tGaPSPSzNe1D1xsOs",
  "account_type":"LINKEDIN",
  "webhook_name":"",
  "user_full_name":"Julien Crépieux",
  "user_provider_id":"ACoAAAh_Ffqss54sqAGQOD8u7sl5of04y9_3AwyM",
  "user_public_identifier":"julien-crepieux",
  "user_profile_url":"https://www.linkedin.com/in/julien-crepieux/",
  "user_picture_url":"https://media.licdn.com/dms/image/v2/D56S3AQHfRb8KQLb56A/profile-displayphoto-shrink_400_400/profile-displayphoto-shrink_400_400/0/14545ssssdde=45465465456&v=beta&t=B_Tqss45Go_ETxNHWbK31fFbHGXjreE1dcW-1weM"
}

Real-Time Method: Applicable for Invitations who includes notes only

If your invitation includes a message, accepting the invitation generates a new chat containing only your invitation message. Leverage the 'new message' webhook to detect this event. It's beneficial to maintain a record of your sent invitations for effective comparison of chat recipient. Alternatively you can test that you are the message sender and that it is the initial message in the chat to infer an accepted invitation.

Periodic Check Method: For Invitations Without Text or Alternative Approach

You can use the list of your relations, sorted by the most recently added. Regularly comparing this list against your sent invitations can help identify new connections, suggesting that your invitation was accepted.

Alternatively, we provides a list of sent invitations. By periodically reviewing this list, you can detect which invitations are no longer pending, indicating acceptance or rejection. You can verify relation with someone with route retrieve a profile. However, if you have many pending invitations, this could result in a large number of API calls.

It's crucial to maintain a record of your sent invitations for effective comparison.
To avoid overwhelming LinkedIn's limits or automation detection, it's recommended to space out these checks only few times by day with random delay, not at fixed time.

By integrating these strategies, you can effectively detect when your LinkedIn invitations are accepted, paving the way for prompt and appropriate follow-up actions.