Is there a webhook event to get the applied tag to a contact?

API Q&A
#1

On behalf of Pabbly Connect Integration, I would like to ask about Webhooks.

I tried all the events but unable to find an event that can return the applied tags only in a contact.

Is there a way? I have used contact.edit event to get the edited contact but, How can I find only the applied tag in that contact?

#2

Yes, if you goto Keap REST API under REST Hooks you can pull a list with the api of all currently available triggers (in this case contactGroup.applied is what you’re looking for):

image
image595×943 11.3 KB

#3

I downloaded this png, because it seems not present inside the rest documentation.
Please make it available and visible there again

#4

Good morning Danilo!

The list of available RestHook event types is constantly changing so we don’t provide it statically in the docs; you will want to make a call to Keap REST API to get the current list.

#5

Thanks for the answer. What happens if I am listening to a hook that suddenly changes?

#6

Events are only removed when features are removed following deprecation, and the behavior would just be to stop pushing that event to listeners.

#7

Ok. Another things that seems to be missing from the documentation.
Where can I find the model of the content of every event?
What should I expect from contactGroup.applied and contactGroup.removed ?

#8

The payloads for each type of resthook are different, based on the object type involved. If you’d like to play with hooks you can use tools like http://ptsv2.com/ to set up/receive the hook payload. Below is a sample of the contactGroup.applied, which I ran against one of out test servers:

{
  "event_key": "contactGroup.applied",
  "object_type": "contactGroup.batch",
  "object_keys": [
    {
      "contact_details": [
        {
          "id": 2579,
          "timestamp": "2022-05-31T18:57:19Z"
        },
        {
          "id": 2483,
          "timestamp": "2022-05-31T18:57:19Z"
        },
        {
          "id": 2473,
          "timestamp": "2022-05-31T18:57:19Z"
        },
        {
          "id": 2455,
          "timestamp": "2022-05-31T18:57:19Z"
        }
      ],
      "tag_id": 113
    },
    {
      "contact_details": [
        {
          "id": 2473,
          "timestamp": "2022-05-31T18:58:13Z"
        }
      ],
      "tag_id": 91
    }
  ],
  "api_url": ""
}