Opp Followers Setup

Add and remove team members as followers on opportunities so they get notified about deal activity. This guide covers both the add and remove endpoints.

Prerequisites

Before you begin, confirm the following:

• A GoHighLevel sub-account with at least one opportunity in a pipeline
• A Private Integration Token (PIT) with the opportunities scope enabled
• Your locationId from Settings > Business Info
• At least one team member’s user ID (visible in Settings > Team Management)
• An existing opportunity ID to add followers to

Set Up Authentication

Follower endpoints use the same Bearer token as all opportunity operations.

1. Go to Settings > Integrations > Private Integrations
2. Select or create a PIT with opportunities scope (read and write)
3. Copy the token:

export GHL_TOKEN="your-private-integration-token"
export LOCATION_ID="your-location-id"

Required headers:

Authorization: Bearer $GHL_TOKEN
Content-Type: application/json
Version: 2021-07-28

Make Your First Call

The follower endpoints work with the opportunity ID and an array of user IDs.

Add followers to an opportunity:

curl -X POST "https://services.leadconnectorhq.com/opportunities/{opportunityId}/followers" \
  -H "Authorization: Bearer $GHL_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Version: 2021-07-28" \
  -d '{
    "followers": ["user-id-1", "user-id-2"]
  }'

The followers field accepts an array of user IDs. You can add one or multiple followers in a single call.

Remove followers from an opportunity:

curl -X DELETE "https://services.leadconnectorhq.com/opportunities/{opportunityId}/followers" \
  -H "Authorization: Bearer $GHL_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Version: 2021-07-28" \
  -d '{
    "followers": ["user-id-1"]
  }'

To find valid user IDs for your team members, check Settings > Team Management in your GHL dashboard. Each user profile URL contains their user ID.

Handle the Response

A successful 200 response for both add and remove operations returns the updated opportunity object with the followers array reflecting the current list of follower IDs.

When you add a follower:

• The user receives notifications for stage changes, notes, and status updates on that opportunity
• The follower appears in the opportunity detail view under the followers section
• Adding a user who is already a follower has no effect (no error, no duplicate)

When you remove a follower:

• The user stops receiving opportunity notifications immediately
• Removing a user who is not a follower returns success with no changes

Common errors:

• 401 — Invalid or expired token.
• 404 — Opportunity ID not found. Verify the ID with a GET call.
• 422 — Invalid user ID in the followers array. Confirm the user exists in your sub-account.

Test Your Setup

Run through these steps to confirm follower management works:

1. GET an opportunity and note the current followers array (may be empty)
2. Add your own user ID as a follower. Confirm the response includes your ID in the followers array.
3. Add a second team member. Confirm both IDs appear in followers.
4. Open the opportunity in the GHL dashboard and verify the followers display correctly.
5. Remove one follower and confirm the array updates.
6. Check that the removed user no longer sees notifications for that opportunity.

If followers do not appear in the dashboard, try refreshing the page. The API updates instantly but the UI may cache the previous state briefly.

Next Steps

Read the full Opp Followers guide for patterns like auto-following based on assignment rules. Pair this with Opportunity CRUD for full deal management, or use the Status Manager to trigger follower additions when opportunities reach specific stages.