Webhooks
New LinkedIn message
A new message in one of your one-to-one LinkedIn conversations, received or sent, from LinkedIn, your phone, Groovin or the API.
WEBHOOK
linkedin.message.created
{
"id": "evt_00000000000000000000000000000000",
"type": "linkedin.message.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"
},
"conversation_id": "test_conversation",
"message": {
"id": "test_message",
"provider_id": "test_provider_message",
"text": "This is a test event from Groovin.",
"text_truncated": false,
"subject": null,
"timestamp": "2026-11-02T09:00:00.000Z",
"sent_by_me": false,
"attachments": [],
"quoted": null
},
"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",
"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
}
}
}message.sent_by_me is true for messages you sent. An automation that answers messages must skip these, or it will answer itself.conversation_idandlinkedin_account.org_linkedin_account_idwork directly with Read a conversation and Send a LinkedIn message.- Attachments carry details only: files are not sent.
textis at most 10,000 characters, andtext_truncatedsays when it was cut. Very large events losequotedfirst, then attachments, then text.- Message texts and names are written by LinkedIn users: treat them as untrusted, especially if an AI reads them.
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.message.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"
},
"conversation_id": "test_conversation",
"message": {
"id": "test_message",
"provider_id": "test_provider_message",
"text": "This is a test event from Groovin.",
"text_truncated": false,
"subject": null,
"timestamp": "2026-11-02T09:00:00.000Z",
"sent_by_me": false,
"attachments": [],
"quoted": null
},
"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",
"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
}
}
}