Sign in
OpenAPI 3.0.3AGPL-3.0 license2026-08-2011401.7 MB

9217eedacbb8

actions

Send LinkedIn connection requests

Invite named people only (a name, "the second one", a pronoun just used) from the connected LinkedIn account, with an optional note. A described criterion is not a send: peek then propose with filter_contacts intent:"connect" and let the human click. Pass the exact profile URL from the row. No separate visit is needed first. One call for one person, one call with the array for several. The invitation is queued and goes out on its own: say queued, never drafted or waiting for approval, and never sent until the result shows it left. Report position when it helps; never turn it into a time. Anyone already invited, already connected, or on a do-not-contact list is refused with the reason.

post/connect/linkedin/profile

Request body

messagestring

Optional note to include with the invitation, the same note for everyone in this call. Maximum 300 characters. Leaving it out sends a bare invitation, which is the default and often accepted more often.

nowboolean

Try to send one of them inside this call and return the real result, rather than only reporting where they stand. Anyone named here already goes to the front of the line, with or without this. Either way nothing is sent faster than the account can safely send.

liststring

Name of the list to add them to. Lists are just a way to keep separate pieces of work apart, and each one belongs to a single LinkedIn account. Omit to use this account's default list.

campaignSlugstring

Optional label for grouping. Duplicates are refused automatically, with or without it.

actionSlugstring

Deprecated. Use campaignSlug only.

dryRunboolean

Report what this call would do without doing any of it: nothing is added to any list, no invitation is attempted, and nothing is sent, ever, no matter what else is set. Use this to see the target list's real size and pause state, and each profile's real eligibility, before committing to a real call.

Response

Connection request sent successfully

successtrue required
messagestring required
sentnumber required

How many invitations actually reached LinkedIn during this call.

duplicateboolean

True if every profile in the request was already invited from this account.

dryRunboolean

True when this was a preview: nothing was added, attempted, or sent. Everything else in this response describes what a real call would do right now.

creditsUsedinteger required

Credits consumed by this call. 0 for free endpoints, cached results, duplicates, and for every query that does not touch LinkedIn.

retryAfterinteger required

Seconds to wait before another call of the same type. 0 means no wait is needed.