st.sendConnectionRequest

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

Constraints

Paramenters

{
  "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.
• 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.
  • 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.
  • 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.