actions

Queue LinkedIn connection requests

Changed on

Invite named people from your own LinkedIn account: the exact profile URL goes in profile, a dictated note in message, one call for one person and one call with the array for several. Say queued, never drafted or waiting for approval, and never sent until the result shows it left; report position, and say when each queued person is expected to go from their sendsAt as an estimate, never a time the result does not give; when blocked is set, say so before anything else. When the user says send about the people found or in their list, they mean connection requests: never ask whether they mean messages. Cost: 1 credit for each invitation, once it is sent.

post/connect/linkedin/profile

Request

  • Base URL: https://api.bereach.ai
  • URL: https://api.bereach.ai/connect/linkedin/profile
  • Auth: HTTP bearer

Request body

messagestring

Optional note on the invitation, the same one for everyone in the call; left out it goes bare.

nowboolean

Attempt one real send inside this call and report what happened, instead of only reporting where they stand. It bypasses this account's sending hours, since a person asking for somebody now is not the scheduled sender; it does not bypass the gap between two invitations.

liststring

Which list to add them to; omit for this account's default one.

dryRunboolean

Previews the call (list size, per-profile eligibility) with a hard guarantee that nothing is added, invited or sent.

placement'front' | 'end'

Where these people join the queue. "front" is ahead of everyone already waiting; "end" is the ordinary place among them. Naming one person defaults to front, handing over several defaults to end. Say either explicitly to override that.

Response

Where each person named now stands: queued, sent in this call, or skipped with the reason

successtrue required
messagestring required
sentnumber required

How many invitations actually reached LinkedIn during this call.

waitingBeforenumber

How many OTHER people were already waiting on this account before this call, the people named here not counted. Worth saying out loud when it is not small and the placement was front.

placement'front' | 'end'

Where the people named actually joined the line, which is what happened rather than what was asked for.

duplicateboolean

True when nothing was sent and nobody joined the line because every profile named already has a reason of its own in skipped: already invited or connected, marked do not contact, given up on, or on a list that is archived. Read skipped for the reason.

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 this call spent, net of anything given back. 0 when nothing was charged: a free read, a cached answer, nothing delivered.

retryAfterinteger required

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

Changes