Skip to main content
POST
List your synced contacts
Safe to try: this reads Groovin’s own data. With include_crm_details, it also makes one CRM request per contact.

What this call does

Your AI assistant reaches the same action through the MCP tool list_synced_crm_contacts.

Authorizations

Authorization
string
header
required

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

Body

application/json
include_crm_details
boolean

true adds name, email and job details from your CRM, at one CRM request per contact.

limit
integer
default:10

The most contacts to return. The playground fills this in for you. The API itself has no default: without limit, you get everything.

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.

Your synced contacts, most recently synced first.

org_linkedin_account_id
integer
required

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

crm_name
string
required

Your CRM, such as "attio".

crm_details_included
boolean
required

true when you asked for CRM details.

total_matched
integer
required

Synced contacts, before limit.

returned
integer
required

Contacts in this answer.

truncated
boolean
required

true when limit left contacts out.

contacts
object[]
required

The contacts.