Developers
Open Swarmhit
DocumentationAPI Reference
Direct actions
POST
/accounts/{id}/connections

Send a LinkedIn connection request from this sender account to a profile, with an optional note. Notes are a premium feature capped at 300 characters; free sender accounts can't include one, so their invites are sent without the note. The profile is tracked as a lead and a connection.accepted webhook fires when it is accepted. Returns 409 when an invitation to the profile is already pending, or 429 when the sender hit its daily cap or its weekly connection-request limit (tier-based: about 130 invites per week for free accounts, 150 for paid; admin-configurable), unless the workspace has the limit bypass enabled.

Authorization

bearerAuth
AuthorizationBearer <token>

An API key created under Settings → API & Webhooks.

In: header

Path Parameters

id*string

Header Parameters

Idempotency-Key?string

Unique key per action (e.g. a UUID). Reusing it replays the first response instead of sending again, so a retry can't double-send. Recommended on all writes.

Lengthlength <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/accounts/string/connections" \  -H "Content-Type: application/json" \  -d '{    "profileUrl": "string"  }'
{  "data": {    "id": "string",    "accountId": "string",    "type": "invitation",    "status": "pending",    "profileUrl": "string",    "publicIdentifier": "string",    "postUrl": "string",    "leadId": "string",    "note": "string",    "error": "string",    "sentAt": "2019-08-24T14:15:22Z",    "acceptedAt": "2019-08-24T14:15:22Z",    "withdrawnAt": "2019-08-24T14:15:22Z",    "createdAt": "2019-08-24T14:15:22Z"  }}

Look up a profile GET

Resolve a LinkedIn profile by its public identifier (the username in linkedin.com/in/&lt;identifier&gt;) from this sender account. A silent read — no profile view is registered.

Message a connection POST

Send a LinkedIn message from this sender account to a profile it is connected to. To reply within an existing inbox conversation, use the inbox endpoint instead. Counts against the sender's daily message cap.