Contact Followers
Manage team member followers on contact records for collaboration notifications. Followers get alerted when their tracked contacts are updated.
Followers are GHL’s built-in collaboration mechanism for contact records. When a team member follows a contact, they receive notifications about updates to that contact — new conversations, pipeline changes, task completions. Managing followers through MCP lets you automatically assign visibility to the right team members based on lead routing rules, territory assignments, or deal ownership.
What This MCP Tool Does
This tool adds and removes team member followers on contact records. When a team member is added as a follower, they receive notifications about activity on that contact. When removed, notifications stop.
Endpoint Reference
Add followers:
POST /contacts/{contactId}/followers
Adds one or more team members as followers on the contact record.
Remove followers:
DELETE /contacts/{contactId}/followers
Removes specified team members from the contact’s follower list.
Authentication
Requires a Private Integration Token (PIT) with the contacts scope enabled.
Key Parameters
followers— array of user IDs to add or remove as followers
Important Notes
Followers receive notifications through GHL’s notification system. The specific notification channels (in-app, email, mobile push) depend on each team member’s personal notification settings.
Following a contact doesn’t change access permissions. Team members can already see all contacts in their location. Following just ensures they get proactively notified about changes rather than having to manually check.
This is most useful in team environments where multiple people work on different aspects of a client relationship. The account manager, the SEO specialist, and the ad buyer might all follow the same high-value contact so everyone stays informed.
Common Questions
What types of updates trigger follower notifications? Typically: new messages, pipeline stage changes, task updates, appointment bookings, and note additions. The exact notification triggers depend on GHL’s notification configuration.
Can I see who’s following a contact? The follower list is part of the contact record data returned by Contact CRUD.
Is there a limit to how many followers a contact can have? No documented limit, but in practice it should be kept to the team members who genuinely need visibility on that contact.
Related MCP Tools
- Contact CRUD — Retrieve follower data as part of the contact record
- Contact Tasks — Tasks assigned to followers create natural collaboration
- Opportunity Followers — Same pattern for deal-level following
- Contact Notes — Notes trigger notifications to followers
- Location Tasks — Cross-contact task visibility for team management