Send connection request

Transport: call this endpoint with HTTP POST and a JSON request body. Send a LinkedIn connection request with optional note. REQUIRES confirmations.requestAction first. Recipient identity may be the canonical identifier or a saved lead/provider/public/profile URL alias; Zevari executes the approved canonical payload. Public REST flow: first call confirmations.requestAction with the exact payload you intend to execute. If Autopilot returns approved=true, retry this endpoint immediately with confirmation_id. Otherwise wait for approval_url to be approved in Zevari, then retry with confirmation_id. Connection request notes are tier-limited: free LinkedIn senders support up to 200 characters; paid/Premium/Sales Navigator senders support up to 300. Over-limit notes return HTTP 400 with ok=false and data.error='connection_note_too_long'. If LinkedIn reports already_invited_recently, treat the recipient as pending invite: do not auto-withdraw, remove/re-add, or send another invite; wait for acceptance before follow-up DMs.

post/v1/linkedin/sendConnectionRequest

Request

Base URL: https://api.zevari.ai
URL: https://api.zevari.ai/v1/linkedin/sendConnectionRequest
Auth: HTTP bearer

Request body

identifierstring

LinkedIn provider ID (ACoAAA...), public identifier, or profile URL. Approval staging canonicalizes this to a provider ID before send.

recipientIdstring

LinkedIn recipient provider ID alias.

linkedin_provider_idstring

LinkedIn provider ID alias from saved lead/profile results.

provider_idstring

LinkedIn provider ID alias from saved lead/profile results.

providerIdstring

LinkedIn provider ID alias.

lead_idstring

Saved lead ID in the active workspace and active LinkedIn account.

leadIdstring

Saved lead ID alias in the active workspace and active LinkedIn account.

linkedin_public_identifierstring

LinkedIn public identifier/vanity slug alias.

public_identifierstring

LinkedIn public identifier/vanity slug alias.

publicIdentifierstring

LinkedIn public identifier/vanity slug alias.

linkedin_profile_urlstring

LinkedIn profile URL alias.

linkedin_urlstring

LinkedIn profile URL alias.

linkedinUrlstring

LinkedIn profile URL alias.

profile_urlstring

LinkedIn profile URL alias.

profileUrlstring

LinkedIn profile URL alias.

urlstring

LinkedIn profile URL alias.

notestring

Connection request note. Free LinkedIn senders support up to 200 characters; paid/Premium/Sales Navigator senders support up to 300. Over-limit notes return data.error='connection_note_too_long'.

confirmation_idstring

REQUIRED. ID from confirmations.requestAction. You MUST call confirmations.requestAction FIRST with the exact payload you intend to send, return the data.approval_url to the user, and wait for them to approve. Only then call this tool with the confirmation_id. Without it, this tool returns an error.

bulk_item_idstring

Set when confirmation_id refers to a bulk_actions parent (from confirmations.requestAction). Identifies the per-item child to consume — e.g. 'itm_03'. Omit for single-action confirmations.

Response

Successful Zevari API response.

okboolean required

False when the underlying tool reports an error or a partial failure.

methodstring required

Public API method name.

dataunknown required

request_idstring required

Request correlation ID. Also returned in X-Zevari-Request-Id.

Example response

{
  "method": "campaigns.delete"
}

Changes

No recorded changes to this operation across all 1 revision of this API.