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.
On: live network lists once per batch, up to 10 profile lookups, and an inbox refresh. Off: none, unless you send URLs
Your CRM
On: properties, notes, chat history. Off: deletes conversation notes
Repeating it
Safe: the contact ends up in the state you asked for. Wait several minutes between On batches. Off: a note that failed to delete stays in your CRM, and repeating will not remove it.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Groovin","colors":{"primary":"#f37546","light":"#d64baf","dark":"#040404"},"logo":{"light":"https://media.brand.dev/8a452a89-9e16-46a4-97fb-c1afa22cee62.svg","dark":"https://media.brand.dev/8a452a89-9e16-46a4-97fb-c1afa22cee62.svg"},"favicon":"https://media.brand.dev/f810fcbb-2382-4110-80c2-f249d1f9f172.png","api":{"playground":{"display":"interactive","proxy":false}},"navbar":{"links":[],"primary":{"type":"button","label":"Get Started","href":"https://groovin.ai"}},"fonts":{"heading":{"family":"Inter","weight":900},"body":{"family":"Inter","weight":400}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"groovin","hasAudioNarration":false,"actualSubdomain":"groovin","customDomains":["docs.groovin.ai"],"gitSource":{"type":"github","owner":"groovin-ai","repo":"groovin-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6aec7b9eb09eb89604ce751a"},"chroma":{"collectionId":"8246c8fd-0dd2-48d9-bcf0-bbf6abdc2cf3","liveDeploymentHistoryId":"6aecaa4b8029e5fb8e3f0b21","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aecaa4b8029e5fb8e3f0b21"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aeceeecd9f359d347c57fe3","clientVersion":"0.0.4071","searchFilterCounts":[{"language":"default","tag":"MCP and API","count":42},{"language":"default","tag":"REST API","count":19},{"language":"default","tag":"MCP Server","count":9},{"language":"default","tag":"LinkedIn","count":8},{"language":"default","tag":"Webhooks","count":7},{"language":"default","tag":"CRM contacts and companies","count":6},{"language":"default","tag":"Get started","count":5},{"language":"default","tag":"Safety and limits","count":5},{"language":"default","tag":"MCP","count":5},{"language":"default","tag":"Get Started","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"reference/api/toggle-sync","slug":"/reference/api/toggle-sync","pageMetadata":{"title":"Turn message sync on or off","description":"Start or stop logging a person's LinkedIn conversation in your CRM, for a batch of contacts.","openapi":"reference/openapi.json POST /crm/contacts/sync-toggle","href":"/reference/api/toggle-sync"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Start or stop logging a person’s LinkedIn conversation in your CRM, for a batch of contacts.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Danger,Heading,Table}=_components;if(!Danger)_missingMdxReference(`Danger`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Danger,{children:_jsxs(_components.p,{children:[`This changes your real CRM. `,_jsx(_components.strong,{children:`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.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`what-this-call-does`,children:`What this call does`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`LinkedIn`})}),_jsx(_components.td,{children:`On: live network lists once per batch, up to 10 profile lookups, and an inbox refresh. Off: none, unless you send URLs`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Your CRM`})}),_jsxs(_components.td,{children:[`On: properties, notes, chat history. Off: `,_jsx(_components.strong,{children:`deletes conversation notes`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Repeating it`})}),_jsx(_components.td,{children:`Safe: the contact ends up in the state you asked for. Wait several minutes between On batches. Off: a note that failed to delete stays in your CRM, and repeating will not remove it.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`good-to-know`,children:`Good to know`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`An HTTP 200 can hold failures: check `,_jsx(_components.code,{children:`status`}),` on each item.`]}),`\n`,_jsx(_components.li,{children:`Affinity logs interactions rather than notes, so turning sync off deletes nothing there.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Your AI assistant reaches the same action through the MCP tool `,_jsx(_components.code,{children:`toggle_linkedin_sync`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Turn message sync on or off","description":"Start or stop logging a person's LinkedIn conversation in your CRM, for a batch of contacts.","openapi":"reference/openapi.json POST /crm/contacts/sync-toggle","href":"/reference/api/toggle-sync"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What this call does","slug":"what-this-call-does","depth":2,"children":[]},{"title":"Good to know","slug":"good-to-know","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"toggle_linkedin_sync","summary":"Turn message sync on or off","description":"Start or stop logging a person's LinkedIn conversation in your CRM, for a batch of contacts.","tags":["CRM contacts and companies"],"requestBody":"44a7d1fe-0161-4005-8166-28192507cf59","responses":{"200":"4470b350-b148-4a9a-9c60-26390ff60bde","400":"0916f8f4-cecc-46c2-ab1d-21088c7f35cf","401":"043f7aad-100a-4e6e-9048-6f468b2d19d7","403":"73571ef8-180a-4616-b227-f334a2eecf0d","404":"716b38bb-bcf1-4043-977e-4a9cf857af6a","429":"350f2895-8705-4403-a940-83e0ff88c230","500":"d38530e5-b8c8-460a-96d2-4c0d8f23b2d6","502":"1042c612-6314-478c-b44d-6b75ef8f1fb9"},"method":"post","type":"path","servers":["a0487c26-68da-4177-9726-8d6498ae07a4"],"security":["3ed4ef1e-3328-437b-84d1-83f04b15cfea"],"path":"/crm/contacts/sync-toggle","baseUrlOptions":["https://api.groovin.ai/functions/v1/api/v1"],"title":"Turn message sync on or off","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"crm_contact_ids":{"type":"array","items":{"type":"string","uniqueKey":"crm_contact_ids.items.[INDEX]","typeLabel":"string"},"description":"The contacts: up to 25 to turn on, 200 to turn off. Always send ids as text: numbers are silently dropped.","isRequired":true,"uniqueKey":"crm_contact_ids","typeLabel":"string[]"},"enabled":{"type":"boolean","description":"`true` turns sync on. `false` turns it off and deletes the notes.","isRequired":true,"uniqueKey":"enabled","typeLabel":"boolean"},"linkedin_profile_urls":{"type":"array","items":{"type":"object","properties":{"crm_contact_id":{"type":"string","description":"The contact. It must also be in `crm_contact_ids`.","isRequired":true,"uniqueKey":"linkedin_profile_urls.items.[INDEX].crm_contact_id","typeLabel":"string"},"linkedin_profile_url":{"type":"string","description":"Their LinkedIn URL. Never guess one: a wrong URL syncs someone else's messages onto this contact.","isRequired":true,"uniqueKey":"linkedin_profile_urls.items.[INDEX].linkedin_profile_url","typeLabel":"string"}},"required":["crm_contact_id","linkedin_profile_url"],"uniqueKey":"linkedin_profile_urls.items.[INDEX]","typeLabel":"object"},"description":"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.","uniqueKey":"linkedin_profile_urls","typeLabel":"object[]"},"org_linkedin_account_id":{"type":"integer","description":"Leave this out to use your own LinkedIn account. Another person's account is refused with a 403.","uniqueKey":"org_linkedin_account_id","typeLabel":"integer"}},"required":["crm_contact_ids","enabled"],"uniqueKey":"","typeLabel":"object"},"examples":{"placeholder":{"title":"placeholder","value":{"crm_contact_ids":["REPLACE_WITH_CRM_CONTACT_ID"],"enabled":true}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"4470b350-b148-4a9a-9c60-26390ff60bde":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","description":"The result of a batch. HTTP 200 does not mean every contact succeeded: check each item.","required":["org_linkedin_account_id","enabled","total","succeeded","failed","results","retry_guidance"],"properties":{"org_linkedin_account_id":{"type":"integer","description":"Groovin's id for the LinkedIn account this answer is about.","isRequired":true,"uniqueKey":"org_linkedin_account_id","typeLabel":"integer"},"enabled":{"type":"boolean","description":"The state you asked for.","isRequired":true,"uniqueKey":"enabled","typeLabel":"boolean"},"total":{"type":"integer","description":"Items in `results`.","isRequired":true,"uniqueKey":"total","typeLabel":"integer"},"succeeded":{"type":"integer","description":"Items toggled.","isRequired":true,"uniqueKey":"succeeded","typeLabel":"integer"},"failed":{"type":"integer","description":"Items that failed.","isRequired":true,"uniqueKey":"failed","typeLabel":"integer"},"results":{"type":"array","items":{"type":"object","description":"What happened for one contact. A contact linked to several LinkedIn profiles gets one item per profile.","required":["crm_contact_id","relocated_to_crm_contact_id","linkedin_profile_id","enabled","status","history_import_triggered","connection_state","conversation_notes_deleted","pair_created","crm_linkedin_url_write_status","crm_linkedin_url_write_error","error","error_status"],"properties":{"crm_contact_id":{"type":"string","description":"The contact you asked about.","isRequired":true,"uniqueKey":"results.items.[INDEX].crm_contact_id","typeLabel":"string"},"relocated_to_crm_contact_id":{"oneOf":[{"type":"string","description":"Set when that record was merged away and Groovin moved the link to the surviving record.","isRequired":true,"uniqueKey":"results.items.[INDEX].relocated_to_crm_contact_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Set when that record was merged away and Groovin moved the link to the surviving record.","isRequired":true,"uniqueKey":"results.items.[INDEX].relocated_to_crm_contact_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].relocated_to_crm_contact_id","typeLabel":"string | null"},"linkedin_profile_id":{"oneOf":[{"type":"string","description":"The LinkedIn profile that was toggled.","isRequired":true,"uniqueKey":"results.items.[INDEX].linkedin_profile_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The LinkedIn profile that was toggled.","isRequired":true,"uniqueKey":"results.items.[INDEX].linkedin_profile_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].linkedin_profile_id","typeLabel":"string | null"},"enabled":{"type":"boolean","description":"The state you asked for.","isRequired":true,"uniqueKey":"results.items.[INDEX].enabled","typeLabel":"boolean"},"status":{"type":"string","enum":["toggled","skipped","error"],"description":"`skipped` usually means no LinkedIn profile could be linked: `error` says why.","isRequired":true,"uniqueKey":"results.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"history_import_triggered":{"type":"boolean","description":"On only: `true` when a first history import started.","isRequired":true,"uniqueKey":"results.items.[INDEX].history_import_triggered","typeLabel":"boolean"},"connection_state":{"oneOf":[{"type":"string","enum":["connected","invitation_pending","not_connected","unknown",null],"description":"On only: how your LinkedIn network sees this person. With `unknown`, nothing was recorded.","isRequired":true,"uniqueKey":"results.items.[INDEX].connection_state.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["connected","invitation_pending","not_connected","unknown",null],"description":"On only: how your LinkedIn network sees this person. With `unknown`, nothing was recorded.","isRequired":true,"uniqueKey":"results.items.[INDEX].connection_state.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].connection_state","typeLabel":"enum\u003cstring> | null"},"conversation_notes_deleted":{"type":"integer","description":"Off only: how many CRM notes Groovin tried to delete. This is the number attempted, not confirmed.","isRequired":true,"uniqueKey":"results.items.[INDEX].conversation_notes_deleted","typeLabel":"integer"},"pair_created":{"type":"boolean","description":"`true` when this call linked the contact to a LinkedIn profile.","isRequired":true,"uniqueKey":"results.items.[INDEX].pair_created","typeLabel":"boolean"},"crm_linkedin_url_write_status":{"oneOf":[{"type":"string","enum":["written","already_present","skipped","failed",null],"description":"What happened to the URL you sent on the CRM record. `null` when you sent none.","isRequired":true,"uniqueKey":"results.items.[INDEX].crm_linkedin_url_write_status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["written","already_present","skipped","failed",null],"description":"What happened to the URL you sent on the CRM record. `null` when you sent none.","isRequired":true,"uniqueKey":"results.items.[INDEX].crm_linkedin_url_write_status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].crm_linkedin_url_write_status","typeLabel":"enum\u003cstring> | null"},"crm_linkedin_url_write_error":{"oneOf":[{"type":"string","description":"Why that URL was not written.","isRequired":true,"uniqueKey":"results.items.[INDEX].crm_linkedin_url_write_error.oneOf.0","typeLabel":"string"},{"type":"null","description":"Why that URL was not written.","isRequired":true,"uniqueKey":"results.items.[INDEX].crm_linkedin_url_write_error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].crm_linkedin_url_write_error","typeLabel":"string | null"},"error":{"oneOf":[{"type":"string","description":"What went wrong for this item, or `null`. Always read it: the rest of the batch can still have succeeded.","isRequired":true,"uniqueKey":"results.items.[INDEX].error.oneOf.0","typeLabel":"string"},{"type":"null","description":"What went wrong for this item, or `null`. Always read it: the rest of the batch can still have succeeded.","isRequired":true,"uniqueKey":"results.items.[INDEX].error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].error","typeLabel":"string | null"},"error_status":{"oneOf":[{"type":"integer","description":"HTTP status behind `error`. `429` means rate limited and `5xx` usually means temporary: retry later. `null` when there is no error.","isRequired":true,"uniqueKey":"results.items.[INDEX].error_status.oneOf.0","typeLabel":"integer"},{"type":"null","description":"HTTP status behind `error`. `429` means rate limited and `5xx` usually means temporary: retry later. `null` when there is no error.","isRequired":true,"uniqueKey":"results.items.[INDEX].error_status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].error_status","typeLabel":"integer | null"}},"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"description":"One item per profile.","isRequired":true,"uniqueKey":"results","typeLabel":"object[]"},"retry_guidance":{"oneOf":[{"type":"string","description":"Plain-text advice when some items failed for a temporary reason, otherwise `null`. Follow it: it says when to retry, and which items.","isRequired":true,"uniqueKey":"retry_guidance.oneOf.0","typeLabel":"string"},{"type":"null","description":"Plain-text advice when some items failed for a temporary reason, otherwise `null`. Follow it: it says when to retry, and which items.","isRequired":true,"uniqueKey":"retry_guidance.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"retry_guidance","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"org_linkedin_account_id":4821,"enabled":true,"total":1,"succeeded":1,"failed":0,"results":[{"crm_contact_id":"example-crm-contact-id","relocated_to_crm_contact_id":null,"linkedin_profile_id":"ACoAAExampleLinkedinProfileId","enabled":true,"status":"toggled","history_import_triggered":true,"connection_state":"connected","conversation_notes_deleted":0,"pair_created":false,"crm_linkedin_url_write_status":null,"crm_linkedin_url_write_error":null,"error":null,"error_status":null}],"retry_guidance":null},"examples":{"Example":{"title":"Example","value":{"org_linkedin_account_id":4821,"enabled":true,"total":1,"succeeded":1,"failed":0,"results":[{"crm_contact_id":"example-crm-contact-id","relocated_to_crm_contact_id":null,"linkedin_profile_id":"ACoAAExampleLinkedinProfileId","enabled":true,"status":"toggled","history_import_triggered":true,"connection_state":"connected","conversation_notes_deleted":0,"pair_created":false,"crm_linkedin_url_write_status":null,"crm_linkedin_url_write_error":null,"error":null,"error_status":null}],"retry_guidance":null}}},"exampleType":"examples"}},"exampleType":"examples"},"0916f8f4-cecc-46c2-ab1d-21088c7f35cf":{"description":"Something in the request is wrong: `error` says what.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"043f7aad-100a-4e6e-9048-6f468b2d19d7":{"description":"The API key is missing, wrong or revoked.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"73571ef8-180a-4616-b227-f334a2eecf0d":{"description":"Your account cannot do this: no CRM connected, inactive subscription, Billing admin role, or a teammate's LinkedIn account.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"716b38bb-bcf1-4043-977e-4a9cf857af6a":{"description":"What you asked for does not exist, or your LinkedIn account is not connected.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"350f2895-8705-4403-a940-83e0ff88c230":{"description":"LinkedIn or your CRM is slowing you down. Wait at least 5 minutes.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"d38530e5-b8c8-460a-96d2-4c0d8f23b2d6":{"description":"Something failed on our side.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1042c612-6314-478c-b44d-6b75ef8f1fb9":{"description":"LinkedIn or your CRM could not be reached or gave an unreadable answer.","content":{"application/json":{"schema":{"type":"object","description":"What every failed request answers, with an HTTP status. The text can change: decide what to do from the status, and show the text to a person.","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, and sometimes what to do next.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"3ed4ef1e-3328-437b-84d1-83f04b15cfea":{"apiKey":{"type":"http","scheme":"bearer","description":"Your Groovin API key (`gv_live_…`), created in the extension under Settings, MCP and API.","scopes":[],"schemeName":"apiKey"}}},"servers":{"a0487c26-68da-4177-9726-8d6498ae07a4":{"url":"https://api.groovin.ai/functions/v1/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your Groovin API key (`gv_live_…`), created in the extension under Settings, MCP and API.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your Groovin API key (`gv_live_…`), created in the extension under Settings, MCP and API.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"reference/openapi.json"},"subdomain":"groovin","siteName":"Groovin","title":"Turn message sync on or off - Groovin","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T19:46:01.580Z","originalFileLocation":"reference/api/toggle-sync.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Start or stop logging a person\u0026#x27;s LinkedIn conversation in your CRM, for a batch of contacts.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Groovin\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://media.brand.dev/f810fcbb-2382-4110-80c2-f249d1f9f172.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://media.brand.dev/f810fcbb-2382-4110-80c2-f249d1f9f172.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://media.brand.dev/f810fcbb-2382-4110-80c2-f249d1f9f172.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://media.brand.dev/f810fcbb-2382-4110-80c2-f249d1f9f172.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"Turn message sync on or off - Groovin\">\u003cmeta data-mint-head property=\"og:description\" content=\"Start or stop logging a person\u0026#x27;s LinkedIn conversation in your CRM, for a batch of contacts.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Groovin\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.groovin.ai/reference/api/toggle-sync\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://groovin.mintlify.app/_mintlify/api/og/v2?division=CRM+contacts+and+companies\u0026amp;title=Turn+message+sync+on+or+off\u0026amp;description=Start+or+stop+logging+a+person%27s+LinkedIn+conversation+in+your+CRM%2C+for+a+batch+of+contacts.\u0026amp;theme=2fb27e555653d3152d4427c9\u0026amp;signature=f6f9f0ff8b425a88c303df323c7bb2c34cbb53de38f76c5ac90ea6a321375941\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Turn message sync on or off - Groovin\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Start or stop logging a person\u0026#x27;s LinkedIn conversation in your CRM, for a batch of contacts.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://groovin.mintlify.app/_mintlify/api/og/v2?division=CRM+contacts+and+companies\u0026amp;title=Turn+message+sync+on+or+off\u0026amp;description=Start+or+stop+logging+a+person%27s+LinkedIn+conversation+in+your+CRM%2C+for+a+batch+of+contacts.\u0026amp;theme=2fb27e555653d3152d4427c9\u0026amp;signature=f6f9f0ff8b425a88c303df323c7bb2c34cbb53de38f76c5ac90ea6a321375941\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/groovin/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Groovin\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#f37546\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.groovin.ai/reference/api/toggle-sync\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/api/toggle-sync.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.groovin.ai/#organization\",\"name\":\"Groovin\",\"url\":\"https://docs.groovin.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://media.brand.dev/8a452a89-9e16-46a4-97fb-c1afa22cee62.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.groovin.ai#website\",\"name\":\"Groovin\",\"url\":\"https://docs.groovin.ai\",\"publisher\":{\"@id\":\"https://docs.groovin.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.groovin.ai/reference/api/toggle-sync#webpage\",\"url\":\"https://docs.groovin.ai/reference/api/toggle-sync\",\"name\":\"Turn message sync on or off\",\"description\":\"Start or stop logging a person's LinkedIn conversation in your CRM, for a batch of contacts.\",\"dateModified\":\"2026-11-05T19:46:01.580Z\",\"isPartOf\":{\"@id\":\"https://docs.groovin.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.groovin.ai/reference/api/toggle-sync#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.groovin.ai/reference/api/toggle-sync#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REST API\",\"item\":\"https://docs.groovin.ai/reference/api/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"CRM contacts and companies\",\"item\":\"https://docs.groovin.ai/reference/api/lookup-contacts\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Turn message sync on or off\",\"item\":\"https://docs.groovin.ai/reference/api/toggle-sync\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.groovin.ai/reference/api/toggle-sync#apireference\",\"headline\":\"Turn message sync on or off\",\"name\":\"Turn message sync on or off\",\"description\":\"Start or stop logging a person's LinkedIn conversation in your CRM, for a batch of contacts.\",\"url\":\"https://docs.groovin.ai/reference/api/toggle-sync\",\"mainEntityOfPage\":{\"@id\":\"https://docs.groovin.ai/reference/api/toggle-sync#webpage\"},\"dateModified\":\"2026-11-05T19:46:01.580Z\",\"publisher\":{\"@id\":\"https://docs.groovin.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.groovin.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Groovin\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Groovin","nav":{"global":null,"tabs":[{"tab":"Getting started","icon":"home","hidden":true},{"tab":"MCP Server","icon":"code","pages":[{"title":"MCP Server","href":"/mcp/overview"}]},{"tab":"MCP and API","groups":[{"group":"Get started","pages":[{"title":"MCP and API","href":"/reference/introduction"},{"title":"Quickstart","href":"/reference/quickstart"},{"title":"Use these docs with your AI assistant","href":"/reference/ai-assistants"},{"title":"Authentication","href":"/reference/authentication"},{"title":"Identifiers","href":"/reference/identifiers"}]},{"group":"Safety and limits","pages":[{"title":"What each call really does","mode":"wide","href":"/reference/side-effects"},{"title":"Limits and quotas","href":"/reference/limits"},{"title":"Errors","href":"/reference/errors"},{"title":"Long lists","href":"/reference/pagination"},{"title":"Changes and compatibility","href":"/reference/versioning"}]},{"group":"REST API","pages":[{"title":"REST API","href":"/reference/api/overview"},{"group":"LinkedIn","pages":[{"title":"List the people in your conversations","openapi":"reference/openapi.json POST /linkedin/conversation-attendees","href":"/reference/api/list-conversation-attendees"},{"title":"Read a conversation","openapi":"reference/openapi.json POST /linkedin/chat-messages","href":"/reference/api/get-chat-messages"},{"title":"Mark a conversation as read or unread","openapi":"reference/openapi.json POST /linkedin/chat-read-status","href":"/reference/api/set-chat-read-status"},{"title":"Get a LinkedIn profile","openapi":"reference/openapi.json POST /linkedin/profile","href":"/reference/api/get-profile"},{"title":"Send a LinkedIn message","openapi":"reference/openapi.json POST /linkedin/messages","href":"/reference/api/send-message"},{"title":"Send a LinkedIn invitation","openapi":"reference/openapi.json POST /linkedin/invitations","href":"/reference/api/send-invitation"},{"title":"List your LinkedIn connections","openapi":"reference/openapi.json POST /linkedin/relations","href":"/reference/api/list-relations"},{"title":"List your pending invitations","openapi":"reference/openapi.json POST /linkedin/pending-invitations","href":"/reference/api/list-pending-invitations"}]},{"group":"CRM contacts and companies","pages":[{"title":"Check who is already in your CRM","openapi":"reference/openapi.json POST /crm/contacts/lookup","href":"/reference/api/lookup-contacts"},{"title":"Create CRM contacts","openapi":"reference/openapi.json POST /crm/contacts","href":"/reference/api/create-contacts"},{"title":"List your synced contacts","description":"See the CRM contacts whose LinkedIn conversation is synced with Groovin, most recently synced first.","openapi":"reference/openapi.json POST /crm/contacts/synced","href":"/reference/api/list-synced-contacts"},{"title":"Turn message sync on or off","openapi":"reference/openapi.json POST /crm/contacts/sync-toggle","href":"/reference/api/toggle-sync"},{"title":"Find missing LinkedIn URLs","description":"Find the LinkedIn URL of CRM contacts that have none, and save it on the contact. Groovin only saves a URL when the evidence is clear.","openapi":"reference/openapi.json POST /crm/contacts/find-linkedin-url","href":"/reference/api/find-linkedin-urls"},{"title":"Find missing company domains","openapi":"reference/openapi.json POST /crm/companies/find-domains","href":"/reference/api/find-company-domains"}]},{"group":"LinkedIn connections import","pages":[{"title":"Start a connections import","openapi":"reference/openapi.json POST /crm/connections-import/start","href":"/reference/api/start-connections-import"},{"title":"Check a connections import","openapi":"reference/openapi.json POST /crm/connections-import/status","href":"/reference/api/get-connections-import"},{"title":"Stop a connections import","openapi":"reference/openapi.json POST /crm/connections-import/cancel","href":"/reference/api/cancel-connections-import"}]},{"title":"Data models","href":"/reference/data-models"}]},{"group":"MCP","pages":[{"title":"Connect your AI tool","href":"/reference/mcp/connect"},{"title":"MCP tools","href":"/reference/mcp/tools"},{"title":"Browser sign-in","href":"/reference/mcp/oauth"},{"title":"Protocol details","href":"/reference/mcp/protocol"},{"title":"MCP errors","href":"/reference/mcp/errors"}]},{"group":"Webhooks","pages":[{"title":"Webhooks","href":"/reference/webhooks/overview"},{"title":"New LinkedIn message","openapi":"reference/openapi.json webhook linkedin.message.created","href":"/reference/webhooks/message-created"},{"title":"New LinkedIn connection","openapi":"reference/openapi.json webhook linkedin.relation.created","href":"/reference/webhooks/relation-created"},{"title":"The crm_contact block","href":"/reference/webhooks/crm-contact"},{"title":"Verify signatures","href":"/reference/webhooks/verify-signatures"},{"title":"Delivery and retries","href":"/reference/webhooks/delivery"},{"title":"Set up a webhook","href":"/reference/webhooks/manage"}]},{"group":"Help","pages":[{"title":"Known issues and troubleshooting","href":"/reference/known-issues"}]}]}]},"basePath":"","title":"Turn message sync on or off - Groovin","buildId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","deploymentId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-B5zPa4Vr.js","utils-CVjrr8Yd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DTgURWzl.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DxTHtkdZ.js","snippetPresets-Cx47o5Vx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-CYZot51e.js","ApiExamples-4Fr6y9N_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Dq2ElbEk.js","shallow-BfYl9r69.js","getApiPlaygroundDisplay-Ch3xc7i1.js","CodeSnippet-BsBxuJ1v.js","CodeSnippets-CetzeDL8.js","getPastedJson-BxPKFSJx.js","icon-o0J1Ochb.js","MethodPill-Du3usO5m.js","DuplicateIcon-DJypyMzl.js","createIcon-YMA6N8KJ.js","DynamicMarkdown-CWvhfcZc.js","SectionHeading-BdLVaXCd.js","axios-vUo_bRtp.js","Markdown-C4Ez6OeV.js","clsx-DptzKFCt.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Dt1IougW.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CZ6Wt2Vb.js"]}