HighLevel

Find HighLevel Contact by Email

Looks up a contact in HighLevel by email address.

Unverified

What the model is told

Look up a contact in HighLevel by the email address the customer gives you. Returns the matching contact, including its ID needed by other HighLevel tools. If no contact is found, none has that email.

Request

GEThttps://services.leadconnectorhq.com/contacts/search/duplicate?locationId=YOUR_HIGHLEVEL_LOCATION_ID&email={{email}}

Headers

  • AuthorizationBearer YOUR_HIGHLEVEL_PRIVATE_INTEGRATION_TOKEN
  • Versionv3

Parameters

  • email stringThe customer's full email address. Use %40 for @ and %2B for + if the email contains special characters.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "82c7f7be-06d4-4f06-8b36-b3c734e8d0ec",
    "type": "HTTP_REQUEST",
    "label": "Find HighLevel Contact by Email",
    "name": "find_highlevel_contact_by_email",
    "customName": false,
    "description": "Look up a contact in HighLevel by the email address the customer gives you. Returns the matching contact, including its ID needed by other HighLevel tools. If no contact is found, none has that email.",
    "parameters": [
      {
        "name": "email",
        "type": "string",
        "description": "The customer's full email address. Use %40 for @ and %2B for + if the email contains special characters."
      }
    ],
    "config": {
      "endpoint": {
        "method": "GET",
        "url": "https://services.leadconnectorhq.com/contacts/search/duplicate?locationId=YOUR_HIGHLEVEL_LOCATION_ID&email={{email}}"
      },
      "headers": [
        {
          "name": "Authorization",
          "value": "Bearer YOUR_HIGHLEVEL_PRIVATE_INTEGRATION_TOKEN"
        },
        {
          "name": "Version",
          "value": "v3"
        }
      ],
      "body": null,
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.