---
ref: tool:heyreagent/send-connection-invitation
name: Send a connection invitation
company: company:heyreagent
workflows: []
access: [mcp, api]
tags: [capability:send-linkedin-messages, category:sales-engagement, has:api, has:mcp]
docs: https://heyreagent.com/docs/actions/send_invitation
updated: 2026-10-25
---

# Send a connection invitation

Sends one LinkedIn connection invitation right away, with an optional note.

Note: Sends at once: confirm first. Takes a profileUrl. 30 a day and 200 in any 7 days on a paid LinkedIn account; 20 and 150 on a free one, where only 5 in 30 days may carry a note (200 characters, 300 on paid). get_usage shows what is left.

## Set up

Use the first option your agent supports.

### MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

```json
{ "mcpServers": { "heyreagent": { "url": "https://api.heyreagent.com/mcp" } } }
```

Call the MCP tool `send_invitation`.

Server URL: https://api.heyreagent.com/mcp

Note: Claude and ChatGPT sign in to HeyReagent in the browser, with no key. Connect the LinkedIn account on heyreagent.com first. Each tool has the same name and inputs as the API action.

### API (official)

- Base URL: https://api.heyreagent.com
- Endpoint: `POST /v1/actions/send_invitation`
- Auth: send the header `Authorization: Bearer $HEYREAGENT_API_KEY`
- Get a key: https://heyreagent.com/t
- Docs: https://heyreagent.com/docs

Note: Every action is a POST to /v1/actions/<name> with its inputs as a JSON body, reads included. Create the key under Menu, then Developers; it is shown once. An answer is { ok: true, result } or { ok: false, error, message }.

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.