Skip to main content

Connect Your GoHighLevel Account for SMS

Send SMS messages to your leads directly through MCA Pilot using your existing GoHighLevel (GHL) or MCA Simplified phone number. This guide walks you through connecting your GHL account to MCA Pilot.

V
Written by Victor Fteha
Updated over a month ago

What You'll Need

Before you begin, make sure you have:

  • An active GoHighLevel sub-account with SMS enabled

  • Admin access to your GHL sub-account settings

You'll be collecting two pieces of information from GoHighLevel:

  1. Private Integration Token - This authenticates MCA Pilot to send messages on your behalf

  2. Location ID - This identifies which GHL sub-account to use

Step 1: Find Your Location ID

Your Location ID is the unique identifier for your GHL sub-account.

  1. Log into your GoHighLevel account

  2. Navigate to your sub-account (not the agency view)

  3. Look at the URL in your browser's address bar. It will look something like: 

    https://app.gohighlevel.com/location/abc123xyz/dashboard

  4. The string after /location/ is your Location ID (in this example: abc123xyz)

  5. Copy this ID and save it somewhere - you'll need it in Step 3

Step 2: Create a Private Integration Token

The Private Integration Token allows MCA Pilot to send SMS messages through your GHL account.

  1. In your GHL sub-account, go to Settings (gear icon in the bottom left)

  2. Scroll down to Other Settings in the left sidebar

  3. Click on Private Integrations

    Note: If you don't see Private Integrations, you may need to enable it in Labs first. Go to Settings > Labs and enable Private Integrations.

  4. Click Create New Integration

  5. Enter the following details:

    • Name: MCA Pilot SMS

    • Description: Allows MCA Pilot to send SMS messages

  6. Click Next

  7. Select these scopes (permissions):

    • ✅ contacts.readonly

    • ✅ conversations/message.write

    • ✅ conversations.write

  8. Click Create

  9. IMPORTANT: Copy your token immediately! You will only see it once.

    • The token starts with pit- followed by a long string

    • Save it somewhere secure - you'll need it in Step 3

Step 3: Add Your GHL Account to MCA Pilot

Now let's connect everything in MCA Pilot.

  1. In MCA Pilot, go to Settings

  2. Click on the Senders tab

  3. In the SMS Accounts table, click + New SMS Account

  4. Fill in the form:

Field

What to Enter

SMS Provider

Select GoHighLevel

API Key

Paste your Private Integration Token (the pit-... token from Step 2)

User ID

Paste your Location ID (from Step 1)

Then click Save

You're All Set! 🎉

MCA Pilot can now send SMS messages through your GoHighLevel account.

Which Phone Number Will Messages Send From?

The GoHighLevel API automatically determines which phone number to use - MCA Pilot cannot specify a particular number. Here's how GHL selects the "from" number:

  1. Existing conversation - If there's already an SMS conversation with the contact, GHL sends from the same number that was used previously (to maintain conversation continuity)

  2. New contact - If there's no prior conversation, GHL sends from your account's default outbound number

  3. Staff assignment - If a staff member is assigned to the contact and has a dedicated phone number, that number may be used

Tip: If you want messages to consistently come from a specific number, make sure that number is set as your default outbound number in your GHL Phone Numbers settings.

Viewing Replies and Conversations

When a contact replies to your SMS, you'll find their response in GoHighLevel's Conversations tab - this is a unified inbox that shows all inbound and outbound messages organized by contact.

To view replies:

  1. In your GHL sub-account, click Conversations in the left sidebar

  2. Unread messages appear in the "Unread" tab

  3. Click on a contact to see the full conversation thread

Additional features:

  • Mobile app - You can also view and respond to messages via the GoHighLevel mobile app

  • Message details - Hover over any message, click the 3-dot menu → "Details" to see from/to info, timestamps, and which automation triggered it

  • Notifications - To get alerted when someone replies, set up a GHL workflow with the "Customer Replied" trigger and a "Send Internal Notification" action

All replies and conversations are handled entirely within GoHighLevel - no additional MCA Pilot setup is required to receive responses.

Troubleshooting

"Invalid token" or authentication errors

  • Make sure you copied the entire Private Integration Token (it's very long)

  • Verify the token starts with pit-

  • Check that you selected the correct scopes when creating the token

"Contact not found" errors

  • The phone number must match a contact in your GHL account

  • Phone numbers should include country code (e.g., +15551234567)

Messages not sending

  • Verify your GHL sub-account has SMS enabled and a phone number assigned

  • Check that your GHL account has sufficient SMS credits

  • Ensure the contact hasn't opted out of SMS (DND)

Need to regenerate your token?

  1. Go to Settings > Private Integrations in GHL

  2. Find your MCA Pilot integration

  3. Click the three-dot menu and select Rotate and expire this token now

  4. Copy the new token and update it in MCA Pilot Settings

Questions?

If you run into any issues connecting your GoHighLevel account, reach out to our support team.

Related Articles
How to Set Up A Sendgrid Account
Did this answer your question?