New Notification System for App & LinkedIn Events

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

Webhook Payload Format

Required fields (all events)

• event_type — notification type
• ghl_company_id — company/agency ID
• timestamp — when the event occurred

Optional fields

Optional fields vary by event type and are included only when available.

Event Payload Examples

1. 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"
}