SalesTouch Docs
All MCP tools
Writes to LinkedInLinkedIn

LinkedIn invite

linkedin_invite

Send a linkedin invitation directly after identity resolution and a persistent recipient lock. Known profile ids require no profile preflight or outgoing invitation scan. Handle provider refusals explicitly; a 3-week cooldown is not proof of an already pending invitation. Previous confirmed sends require explicit resend authorization. Uncertain send outcomes block retries.

When to use it

Send a LinkedIn connection invitation, optionally with a short note.

Required scopes
linkedin:accesssalestouch:use
Execution
Synchronous MCP tool call

Requirements

Provide one member target: identifier, recipient, linkedin_url, profile_url, or handle.

Example

Ask your agent

Invite https://www.linkedin.com/in/example to connect with the note “Would love to connect.”

Tool arguments
{
  "linkedin_url": "https://www.linkedin.com/in/example",
  "message": "Would love to connect.",
  "queue": true
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: A sent or queued invitation result.

Parameters

account_id
string

Connected SalesTouch account id, username, email, handle, or account URL.

identifierrequired
string

LinkedIn member handle, public id, account id, or profile URL.

queue
boolean

Set true to queue this action when it cannot run now.

scheduled_for
string

Future ISO 8601 datetime with timezone. The action will never run before this time and queueing is implicit.

text
string

Optional invitation note.

retry_invitation
boolean

Explicit user authorization for another attempt after a confirmed send. Never overrides uncertain outcomes or the stored 3-week cooldown; no full invitation scan.

Aliases are shown independently because MCP clients send a flat JSON object. Use one alias from each required group, not every alias.

Common errors

insufficient_scope

Reconnect the MCP and approve the requested LinkedIn permission.

paid_plan_required

Follow the error's action_url: start the free trial, choose a plan after a trial or subscription ended, or update the payment method after a failed payment. details.reason names which one.

trial_payment_method_required

Retry after a minute if checkout was just completed; otherwise add a payment method in SalesTouch billing to activate the trial and LinkedIn MCP access.

action_limit_queue_required

Repeat the call with queue set to true.

invitation_cooldown

Do not automatically retry. Check lead_status for a pending invitation or a recently handled request; a later resend requires explicit user authorization.

invitation_status_unknown

Read lead_status again. Do not send or automatically retry while invitation_status is unknown.

invitation_outcome_unknown

Read lead_status again. Do not send or automatically retry while invitation_status is unknown.

invitation_note_too_long

Keep the note under 300 characters (200 on free seats), or call retry_tool with retry_with to send it without a note.

invitation_note_unavailable

The seat's personalized invitations are used up. Call retry_tool with retry_with to send the invitation without a note.

invitation_limit_reached

The seat hit LinkedIn's weekly invitation limit. Stop inviting from it for several days; queue or schedule invitations instead.

invitation_already_pending

An invitation was already sent. Check lead_status; do not send another.

invitation_requires_email

The member only accepts invitations from people who know their email. Reach them another way.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools