Skip to main content
POST
Turn message sync on or off
This changes your real CRM. Turning sync off deletes the conversation notes Groovin wrote on Attio and HubSpot. Turning it on reads LinkedIn live, then writes properties, notes and the chat history.

What this call does

Good to know

  • An HTTP 200 can hold failures: check status on each item.
  • Affinity logs interactions rather than notes, so turning sync off deletes nothing there.
Your AI assistant reaches the same action through the MCP tool toggle_linkedin_sync.

Authorizations

Authorization
string
header
required

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

Body

application/json
crm_contact_ids
string[]
required

The contacts: up to 25 to turn on, 200 to turn off. Always send ids as text: numbers are silently dropped.

enabled
boolean
required

true turns sync on. false turns it off and deletes the notes.

linkedin_profile_urls
object[]

LinkedIn URLs for contacts Groovin cannot match on its own, up to 25. The URL is saved on the contact only if that field is empty.

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.

The result of a batch. HTTP 200 does not mean every contact succeeded: check each item.

org_linkedin_account_id
integer
required

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

enabled
boolean
required

The state you asked for.

total
integer
required

Items in results.

succeeded
integer
required

Items toggled.

failed
integer
required

Items that failed.

results
object[]
required

One item per profile.

retry_guidance
string | null
required

Plain-text advice when some items failed for a temporary reason, otherwise null. Follow it: it says when to retry, and which items.