Keap

Find Keap Contact by Email

Looks up a contact in Keap by email address.

Unverified

What the model is told

Look up a contact in Keap by the exact email address the customer gives you. Returns the matching contact with its ID, name, email and phone numbers. The ID is needed by other Keap tools. If the contacts list is empty, no contact has that email.

Request

GEThttps://api.infusionsoft.com/crm/rest/v2/contacts?filter=email=={{email}}&page_size=1&fields=id,given_name,family_name,email_addresses,phone_numbers

Headers

  • AuthorizationBearer YOUR_KEAP_API_KEY
  • Acceptapplication/json

Parameters

  • email stringThe customer's full email address. Do not use wildcards.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "0d5bee3a-0f2c-414e-b5fc-b9bfe62d9a6a",
    "type": "HTTP_REQUEST",
    "label": "Find Keap Contact by Email",
    "name": "find_keap_contact_by_email",
    "customName": false,
    "description": "Look up a contact in Keap by the exact email address the customer gives you. Returns the matching contact with its ID, name, email and phone numbers. The ID is needed by other Keap tools. If the contacts list is empty, no contact has that email.",
    "parameters": [
      {
        "name": "email",
        "type": "string",
        "description": "The customer's full email address. Do not use wildcards."
      }
    ],
    "config": {
      "endpoint": {
        "method": "GET",
        "url": "https://api.infusionsoft.com/crm/rest/v2/contacts?filter=email=={{email}}&page_size=1&fields=id,given_name,family_name,email_addresses,phone_numbers"
      },
      "headers": [
        {
          "name": "Authorization",
          "value": "Bearer YOUR_KEAP_API_KEY"
        },
        {
          "name": "Accept",
          "value": "application/json"
        }
      ],
      "body": null,
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.