Skip to main content

Actions

st.checkConnectionStatus

This action allows you to check the connection status between your account and another person.

If you need to perform several connection status checks, use this action multiple times within an array workflow. This approach is significantly faster than creating separate workflows for each check due to API optimizations.

Constraints

⏺️
Root Start: allowed, when personUrl parameter is provided.
⬆️
Parent Actions: st.openPersonPage.
⬇️
Child Actions: N/A.

Paramenters


{
  "actionType": "st.checkConnectionStatus",
  "label": "person1",
  "personUrl": "https://www.linkedin.com/in/person1"
}
  • personUrl (required for root start, forbidden for parent start) – public or hashed LinkedIn URL of the person you want to check a connection status with.
  • label (optional) – custom label for tracking this action in workflow completion.

Result options

  1. Successful connection check:

{
  "actionType": "st.checkConnectionStatus",
  "label": "person1",
  "success": true,
  "data": {
    "connectionStatus": "pending"
  }
}
  • label – included only if specified in the action parameters.
  • data.connectionStatus – enum with the following possible values:
    • connected – your account is connected with the person.
    • notConnected – your account is not connected with the person.
    • pending – your account has a pending connection request to the person.
  1. Failed connection check:

{
  "actionType": "st.checkConnectionStatus",
  "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.