Skip to main content
POST
Send a LinkedIn message
This sends a real message from your LinkedIn account, and it cannot be taken back. Check the text and the recipient before you press Send. A conversation_id can be a group: everyone in it gets the message.

What this call does

Good to know

  • Send exactly one of conversation_id, linkedin_profile_id, sales_nav_profile_id, linkedin_profile_slug or crm_contact_id.
  • sent: true means LinkedIn accepted the message.
  • Do not build bulk sequences with this route. It is made for one approved message at a time, and sending too much can get your LinkedIn account restricted.
Your AI assistant reaches the same action through the MCP tool send_linkedin_message.

Authorizations

Authorization
string
header
required

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

Body

application/json
text
string
required

The message, up to 8,000 characters.

conversation_id
string

Who to reach, by existing conversation: the best option. It can be a group conversation.

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.

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 message.

org_linkedin_account_id
integer
required

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

sent
any
required

Always true on success.

conversation_id
string | null
required

The conversation the message went to.

message_id
string | null
required

The new message's id, when LinkedIn gives one.

recipient_linkedin_profile_id
string | null
required

Who it was addressed to. null when you sent a conversation_id.

recipient_resolution
enum<string>
required

How Groovin found the recipient.

Available options:
conversation_id,
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.