Skip to main content
POST
Send a LinkedIn invitation
This sends a real invitation from your LinkedIn account. Invitations are LinkedIn’s most restricted action: stay around 80 to 100 a day and 200 a week. Your CRM can also be updated.

What this call does

Good to know

  • Send exactly one of linkedin_profile_id, sales_nav_profile_id, linkedin_profile_slug or crm_contact_id.
  • sent: true means LinkedIn accepted the invitation.
  • Check your connections and pending invitations first: a repeat attempt wastes your quota.
Your AI assistant reaches the same action through the MCP tool send_linkedin_invitation.

Authorizations

Authorization
string
header
required

Your Groovin API key (gv_live_…), created in the extension under Settings, MCP and API.

Body

application/json
message
string

An optional note, up to 300 characters. Leave it out for an invitation without a note.

linkedin_profile_id
string

Who to reach, by LinkedIn profile id (ACoAA…).

sales_nav_profile_id
string

Who to reach, by Sales Navigator profile id (ACwAA…).

linkedin_profile_slug
string

Who to reach, by the end of their LinkedIn URL. This can cost one live LinkedIn profile view, and a URL that changed owner can point to someone else: prefer an id.

crm_contact_id
string

Who to reach, by CRM contact id. The contact needs a linked profile or a LinkedIn URL on its record.

recipient_email
string

Their email address, if LinkedIn refuses the invitation because it needs one.

org_linkedin_account_id
integer

Leave this out to use your own LinkedIn account. Another person's account is refused with a 403.

Response

Success.

LinkedIn accepted the invitation.

org_linkedin_account_id
integer
required

Groovin's id for the LinkedIn account this answer is about.

sent
any
required

Always true on success.

invitation_id
string | null
required

The invitation's id, when LinkedIn gives one.

recipient_linkedin_profile_id
string
required

Who it was addressed to.

recipient_resolution
enum<string>
required

How Groovin found the recipient.

Available options:
provided_id,
provided_slug,
pair_table,
crm_record
used_live_profile_fetch
boolean
required

true when finding the recipient cost one live LinkedIn profile view. Automatic contact creation can cost one more.

crm_contact_id
string | null
required

The CRM contact the invitation was recorded on, if any.

crm_contact_auto_created
boolean
required

true when this call created a brand-new CRM contact. false when it only linked an existing one.