st.sendConnectionRequest

This action allows you to send a connection request from your account to another person.

Constraints

Paramenters

{
  "actionType": "st.sendConnectionRequest",
  "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": "person1"
}

• 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.
• label (optional) – custom label for tracking this action in workflow completion.

Result options

1. Successful connection request sending:

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

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

2. Failed connection request sending:

{
  "actionType": "st.sendConnectionRequest",
  "success": false,
  "label": "person1",
  "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.