# 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](/docs/action-st-open-person-page).

> ⬇️ **Child Actions:** N/A.

## Parameters

```json
{
  "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](/faq/what-are-hashed-url-and-public-url) 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). LinkedIn may also limit how many personalized invitation notes a free account can send.
- `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:**

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

- `label` – included only if specified in the action parameters.

2. **Failed connection request sending:**

```json
{
  "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.
  - `noteLimitExceeded` – your LinkedIn account has reached the limit for personalized invitation notes. Send the connection request without a note, or buy LinkedIn Premium to include one.
  - `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.