Webhooks
New LinkedIn connection
LinkedIn reports a new 1st-degree connection: usually someone who accepted your invitation, sometimes someone whose invitation you accepted.
WEBHOOK
linkedin.relation.created
{
"id": "evt_00000000000000000000000000000000",
"type": "linkedin.relation.created",
"timestamp": "2026-11-02T09:00:00.000Z",
"is_test": true,
"data": {
"groovin_user": {
"id": "00000000-0000-0000-0000-000000000000",
"email": "you@example.com",
"name": "Your Name",
"crm_name": "attio",
"crm_org_id": "your_crm_org_id",
"crm_user_id": "your_crm_user_id"
},
"linkedin_account": {
"org_linkedin_account_id": 0,
"linkedin_profile_id": "ACoAA_YOUR_LINKEDIN_PROFILE_ID",
"name": "Your Name"
},
"detected_at": "2026-11-02T09:00:00.000Z",
"contact": {
"linkedin_profile_id": "ACoAA_TEST",
"sales_nav_profile_id": null,
"slug": "groovin-test-contact",
"name": "Test Contact",
"profile_url": "https://www.linkedin.com/in/groovin-test-contact",
"picture_url": null,
"is_crm_contact_creation_blocked": false
},
"crm_contact": {
"status": "paired",
"crm_contact_id": "test_crm_contact",
"crm_url": null,
"already_paired_in_groovin": true,
"crm_contact_auto_created": false,
"auto_create_outcome": null,
"matched_crm_contact_ids": null,
"is_msg_sync_enabled": true
}
}
}Reported up to about 8 hours after it happened.
detected_atis when LinkedIn reported the connection.- Missed events are not replayed. To catch up, use List your LinkedIn connections with
connected_after. picture_urlis a temporary LinkedIn image link.contact.sales_nav_profile_idis alwaysnullon this event.
Authorizations
Your Groovin API key (gv_live_…), created in the extension under Settings, MCP and API.
Body
application/json
Unique per event and per URL, and the same on every retry. Use it to skip events you already handled.
The event type.
When the event happened, not when it was sent to you (ISO 8601).
true for a test event sent from the settings page.
Show child attributes
Show child attributes
Response
Any 2xx status, within 10 seconds, confirms delivery.
⌘I
{
"id": "evt_00000000000000000000000000000000",
"type": "linkedin.relation.created",
"timestamp": "2026-11-02T09:00:00.000Z",
"is_test": true,
"data": {
"groovin_user": {
"id": "00000000-0000-0000-0000-000000000000",
"email": "you@example.com",
"name": "Your Name",
"crm_name": "attio",
"crm_org_id": "your_crm_org_id",
"crm_user_id": "your_crm_user_id"
},
"linkedin_account": {
"org_linkedin_account_id": 0,
"linkedin_profile_id": "ACoAA_YOUR_LINKEDIN_PROFILE_ID",
"name": "Your Name"
},
"detected_at": "2026-11-02T09:00:00.000Z",
"contact": {
"linkedin_profile_id": "ACoAA_TEST",
"sales_nav_profile_id": null,
"slug": "groovin-test-contact",
"name": "Test Contact",
"profile_url": "https://www.linkedin.com/in/groovin-test-contact",
"picture_url": null,
"is_crm_contact_creation_blocked": false
},
"crm_contact": {
"status": "paired",
"crm_contact_id": "test_crm_contact",
"crm_url": null,
"already_paired_in_groovin": true,
"crm_contact_auto_created": false,
"auto_create_outcome": null,
"matched_crm_contact_ids": null,
"is_msg_sync_enabled": true
}
}
}