Keap

Create Keap Contact

Adds a new contact to Keap, or updates the existing one with the same email.

Unverified

What the model is told

Create a contact in Keap. Confirm the name and email address with the customer first. If a contact with the same email already exists it is updated instead of duplicated. Returns the contact including its ID.

Request

POSThttps://api.infusionsoft.com/crm/rest/v2/contacts?duplicate_option=Email&fields=id,given_name,family_name

Headers

  • AuthorizationBearer YOUR_KEAP_API_KEY
  • Acceptapplication/json
  • Content-Typeapplication/json

Body

{
  "given_name": "{{firstName}}",
  "family_name": "{{lastName}}",
  "email_addresses": [
    {
      "email": "{{email}}",
      "field": "EMAIL1"
    }
  ]
}

Parameters

  • firstName stringThe customer's first name.
  • lastName stringThe customer's last name.
  • email stringThe customer's email address.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "abaa8441-b962-4de9-b266-0550cfc05d76",
    "type": "HTTP_REQUEST",
    "label": "Create Keap Contact",
    "name": "create_keap_contact",
    "customName": false,
    "description": "Create a contact in Keap. Confirm the name and email address with the customer first. If a contact with the same email already exists it is updated instead of duplicated. Returns the contact including its ID.",
    "parameters": [
      {
        "name": "firstName",
        "type": "string",
        "description": "The customer's first name."
      },
      {
        "name": "lastName",
        "type": "string",
        "description": "The customer's last name."
      },
      {
        "name": "email",
        "type": "string",
        "description": "The customer's email address."
      }
    ],
    "config": {
      "endpoint": {
        "method": "POST",
        "url": "https://api.infusionsoft.com/crm/rest/v2/contacts?duplicate_option=Email&fields=id,given_name,family_name"
      },
      "headers": [
        {
          "name": "Authorization",
          "value": "Bearer YOUR_KEAP_API_KEY"
        },
        {
          "name": "Accept",
          "value": "application/json"
        },
        {
          "name": "Content-Type",
          "value": "application/json"
        }
      ],
      "body": "{\n  \"given_name\": \"{{firstName}}\",\n  \"family_name\": \"{{lastName}}\",\n  \"email_addresses\": [\n    {\n      \"email\": \"{{email}}\",\n      \"field\": \"EMAIL1\"\n    }\n  ]\n}",
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.