st.sendMessage

This action allows you to send a message to a person.

Constraints

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

⬆️ Parent Actions: st.openPersonPage.

⬇️ Child Actions: N/A.

Parameters

json
{
  "actionType": "st.sendMessage",
  "label": "person1",
  "personUrl": "https://www.linkedin.com/in/person1",
  "text": "Hi! I'd love to connect and discuss some ideas."
}
  • 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 message to.
  • text – message text, must be up to 1900 characters.

Result options

  1. Successful message sending:
json
{
  "actionType": "st.sendMessage",
  "label": "person1",
  "success": true
}
  • label – included only if specified in the action parameters.
  1. Failed message sending:
json
{
  "actionType": "st.sendMessage",
  "label": "person1",
  "success": false,
  "error": {
    "type": "personNotFound",
    "message": "The provided URL is not an existing LinkedIn person."
  }
}
  • 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.
    • messagingNotAllowed – sending a message to the person is not allowed. This could happen for several reasons:
      • You are not connected to the person.
      • LinkedIn has restricted your ability to send messages to the person, for example, due to reaching message limits or the person’s privacy settings.