Installation

Connect your GoHighLevel sub-account by creating a Private Integration Token with the right scopes.

To connect Social Sourced to your GoHighLevel sub-account, you'll create a Private Integration Token (PIT) inside GHL and paste it into Social Sourced's settings page. The whole thing takes about three minutes.

Why a Private Integration Token?

A PIT is GHL's recommended way for a single sub-account to grant a third-party tool access without going through a full OAuth marketplace install. It's:

  • Scoped — you choose exactly what Social Sourced can read.
  • Read-only — every scope we ask for is *.readonly. We don't write to your CRM.
  • Revocable — you can delete the token from GHL at any time and the connection drops immediately.

Step 1 — Open Private Integrations in GHL

  1. Log into your GoHighLevel sub-account.
  2. Go to Settings → Private Integrations.
  3. Click Create new integration.

Step 2 — Select the required scopes

Social Sourced needs read access to a small set of resources so it can pull calendar URLs, custom values, custom fields, trigger links, and contact info into your replies. Check the following scopes:

GHL Private Integration scopes — View Calendars, View Links, View Custom Values, View Custom Fields, View Contacts, View Locations

The exact scope names are:

ScopeWhat it unlocks
calendars.readonlyCalendar dropdown for booking links in replies.
links.readonlyTrigger Links picker.
locations/customValues.readonlyCustom Values in the merge-tag picker.
locations/customFields.readonlyCustom Fields in the merge-tag picker.
contacts.readonlyStandard contact fields (first name, address, city, state, postal code, country, etc.) in the merge-tag picker.
locations.readonlyLocation name (so the integration shows the right sub-account in Settings).

If you skip one of these, the related picker will show up empty inside Social Sourced — nothing breaks, but you won't see those merge tags.

Step 3 — Create and copy the token

  1. Give the integration a name (we recommend "Social Sourced").
  2. Click Create.
  3. GHL will display the token once. Copy it now — if you close the dialog you'll have to generate a new one.

Step 4 — Paste the token into Social Sourced

  1. Inside Social Sourced, open Settings → GoHighLevel integration.
  2. Paste the token into the field and click Save.
  3. Social Sourced will validate the token by fetching your calendars. If it works, you'll see a green confirmation with your sub-account name and the number of calendars detected.

The token is encrypted at rest. We never log or display the full value after you paste it — only the last four characters appear in the UI.

Step 5 — Install the Master Workflow

The PIT covers everything Social Sourced reads from GHL. To send replies, you'll also need the Master Workflow installed in your sub-account. We'll walk you through that on first run, or you can re-run the setup from Settings → GoHighLevel integration → Reinstall workflow.

Revoking access

To disconnect Social Sourced from a sub-account:

  • Inside Social Sourced — click Disconnect on the integration card. The encrypted token is deleted from our database.
  • Inside GHL — go to Settings → Private Integrations, find your "Social Sourced" entry, and delete it. The token is invalidated immediately.

Either action is sufficient. Doing both is fine and harmless.