Keap

Apply Keap Tag to Contact

Applies an existing tag to a contact in Keap.

Unverified

What the model is told

Apply a tag to a Keap contact. Use only a tag ID you have been told to use, and confirm with the customer before tagging them. Find the contact's ID first with Find Keap Contact by Email. Returns a results object with the outcome for the contact ID.

Request

POSThttps://api.infusionsoft.com/crm/rest/v2/tags/{{tagId}}/contacts:applyTags

Headers

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

Body

{
  "contact_ids": [
    "{{contactId}}"
  ]
}

Parameters

  • tagId stringThe Keap ID of the tag to apply.
  • contactId stringThe Keap ID of the contact, from Find Keap Contact by Email.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "8600f87a-c015-443a-ab7c-181d468369c4",
    "type": "HTTP_REQUEST",
    "label": "Apply Keap Tag to Contact",
    "name": "apply_keap_tag_to_contact",
    "customName": false,
    "description": "Apply a tag to a Keap contact. Use only a tag ID you have been told to use, and confirm with the customer before tagging them. Find the contact's ID first with Find Keap Contact by Email. Returns a results object with the outcome for the contact ID.",
    "parameters": [
      {
        "name": "tagId",
        "type": "string",
        "description": "The Keap ID of the tag to apply."
      },
      {
        "name": "contactId",
        "type": "string",
        "description": "The Keap ID of the contact, from Find Keap Contact by Email."
      }
    ],
    "config": {
      "endpoint": {
        "method": "POST",
        "url": "https://api.infusionsoft.com/crm/rest/v2/tags/{{tagId}}/contacts:applyTags"
      },
      "headers": [
        {
          "name": "Authorization",
          "value": "Bearer YOUR_KEAP_API_KEY"
        },
        {
          "name": "Accept",
          "value": "application/json"
        },
        {
          "name": "Content-Type",
          "value": "application/json"
        }
      ],
      "body": "{\n  \"contact_ids\": [\n    \"{{contactId}}\"\n  ]\n}",
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.