st.sendConnectionRequest

This action allows you to send a connection request to a person.

Constraints

⏺️ Root Start: allowed, when personUrl parameter is provided.

⬆️ Parent Actions: st.openPersonPage.

⬇️ Child Actions: N/A.

Parameters

{
  "actionType": "st.sendConnectionRequest",
  "label": "person1",
  "personUrl": "https://www.linkedin.com/in/person1",
  "note": "Hi, I’d like to connect with you to discuss potential collaboration.",
  "email": "example1@gmail.com"
}

• label (optional) – custom label for tracking this action in workflow completion.
• personUrl (required for root start, forbidden for parent start) – public or hashed LinkedIn URL of the person you want to send a connection request to.
• note (optional) – note to include with the connection request, must be up to 300 characters (LinkedIn allows 200 for free accounts and 300 for Premium).
• email (optional) – email address required by some people for sending connection requests to them. If it is required and not provided, the connection request will fail.

Result options

1. Successful connection request sending:

{
  "actionType": "st.sendConnectionRequest",
  "label": "person1",
  "success": true
}

• label – included only if specified in the action parameters.

2. Failed connection request sending:

{
  "actionType": "st.sendConnectionRequest",
  "label": "person1",
  "success": false,
  "error": {
    "type": "emailRequired",
    "message": "The person requires an email address to send a connection request."
  }
}

• label – included only if specified in the action parameters.
• error.type – enum with the following possible values:
  • personNotFound – provided URL is not an existing LinkedIn person.
  • selfProfileNotAllowed – action cannot be performed on your own profile.
  • alreadyPending – connection request to this person has already been sent and is still pending.
  • alreadyConnected – your LinkedIn account is already connected with this person.
  • emailRequired – person requires an email address to send a connection request.
  • noteTooLong – the note exceeds the character limit allowed by LinkedIn. Free accounts are limited to 200 characters, Premium accounts to 300.
  • requestNotAllowed – LinkedIn has restricted sending a connection request to this person. This can happen for the following reasons:
    • The person has disabled connection requests in their privacy settings.
    • You recently sent and withdrew a connection request to this person.
    • You have reached LinkedIn's daily, weekly, or monthly limits for sending connection requests.