Overview
We’ve introduced a new notification system so you can monitor important account activity as it happens.
You can now configure:
- Email recipients to receive event alerts by email
- Webhook URL to receive event payloads programmatically
This helps teams stay informed and automate responses when critical events occur.
Supported events
App events
- App installed on a sub-account
- App uninstalled
LinkedIn events
- Account disconnected
- Account deleted
- Account blocked
- Authentication error
- Account reconnected
- Rate limit hit
Required fields (all events)
event_type — notification typeghl_company_id — company/agency IDtimestamp — when the event occurred
Optional fields
Optional fields vary by event type and are included only when available.
Event Payload Examples
- Install - When an app is installed on a sub-account
{
"event_type": "install",
"ghl_company_id": "fhRhvcLbntMZs3hVo5L4",
"ghl_location_id": "tdIePnL9kWCtdO7z6Md5",
"installer_name": "Daniel Marr",
"installer_email": "daniel@think3.co",
"ghl_user_id": "bHclZxQvtmD5wT7SYwsc",
"timestamp": "2026-03-21T00:22:16.000Z"
}
2. Uninstall - When an app is uninstalled
{
"event_type": "uninstall",
"ghl_company_id": "fhRhvcLbntMZs3hVo5L4",
"ghl_location_id": "tdIePnL9kWCtdO7z6Md5",
"timestamp": "2026-03-21T00:22:16.000Z"
}
3. LinkedIn Account Disconnected - When user disconnects their LinkedIn
{
"event_type": "linkedin_disconnected",
"ghl_company_id": "fhRhvcLbntMZs3hVo5L4",
"ghl_location_id": "tdIePnL9kWCtdO7z6Md5",
"linkedin_account_name": "John Doe",
"timestamp": "2026-03-21T00:22:16.000Z"
}
4. LinkedIn Account Deleted - When user deletes their LinkedIn integration
{
"event_type": "linkedin_deleted",
"ghl_company_id": "fhRhvcLbntMZs3hVo5L4",
"ghl_location_id": "tdIePnL9kWCtdO7z6Md5",
"linkedin_account_name": "John Doe",
"timestamp": "2026-03-21T00:22:16.000Z"
}
5. LinkedIn Account Blocked - When LinkedIn account is blocked
{
"event_type": "linkedin_blocked",
"ghl_company_id": "fhRhvcLbntMZs3hVo5L4",
"ghl_location_id": "tdIePnL9kWCtdO7z6Md5",
"linkedin_account_name": "John Doe",
"timestamp": "2026-03-21T00:22:16.000Z"
}
6. LinkedIn Authentication Error - When LinkedIn auth needs to be refreshed
{
"event_type": "linkedin_auth_error",
"ghl_company_id": "fhRhvcLbntMZs3hVo5L4",
"ghl_location_id": "tdIePnL9kWCtdO7z6Md5",
"linkedin_account_name": "John Doe",
"error_detail": "Token expired",
"timestamp": "2026-03-21T00:22:16.000Z"
}
7. LinkedIn Account Reconnected - When a blocked account is unblocked or auth is refreshed
{
"event_type": "linkedin_reconnected",
"ghl_company_id": "fhRhvcLbntMZs3hVo5L4",
"ghl_location_id": "tdIePnL9kWCtdO7z6Md5",
"linkedin_account_name": "John Doe",
"timestamp": "2026-03-21T00:22:16.000Z"
}
8. LinkedIn Rate Limit - When API rate limits are hit
{
"event_type": "linkedin_rate_limit",
"ghl_company_id": "fhRhvcLbntMZs3hVo5L4",
"ghl_location_id": "tdIePnL9kWCtdO7z6Md5",
"linkedin_account_name": "John Doe",
"limit_type": "Daily",
"api_name": "Search People",
"resets_at": "2026-03-22T00:00:00.000Z",
"timestamp": "2026-03-21T00:22:16.000Z"
}