# How to use Tag Removed Webhook

Tags help you organize customers.

But what happens when a tag is removed?

That moment is just as important as when a tag is added.

Because a removed tag usually means something has changed:

* A lead has moved to the next stage
* A task has been completed
* A customer is no longer relevant for a campaign

If your system doesn’t capture this change instantly, your data becomes outdated — and your communication becomes inaccurate.

The **Tag Removed Webhook** ensures that doesn’t happen.

The moment a tag is removed, your system is notified — so you can take action immediately.

***

#### <mark style="color:$primary;">**What Is the Tag Removed Webhook?**</mark>

This webhook triggers whenever a tag is removed from:

* A customer profile
* A conversation

In simple terms:

**Tag removed → webhook fires → system updates instantly**

It helps you keep your systems aligned with the latest customer state.

***

#### <mark style="color:$primary;">**When Does This Webhook Trigger?**</mark>

This webhook activates whenever a tag is removed, regardless of how it happens:

* When a team member removes a tag manually
* When a bot removes a tag automatically
* When a workflow updates or replaces tags

No matter the source — the webhook will always trigger.

***

#### <mark style="color:$primary;">**Step-by-Step Setup Guide**</mark>

<figure><img src="/files/ezI3nOvv7O4CjHlCaKts" alt=""><figcaption></figcaption></figure>

#### <mark style="color:$primary;">**Step 1: Go to Webhooks**</mark>

* Log in to your DoubleTick account
* Go to **Settings**
* Click on **Webhooks**

#### <mark style="color:$primary;">**Step 2: Create a New Webhook**</mark>

* Click **New Webhook**
* Enter a name (example: *Tag Removed Tracker*)

#### <mark style="color:$primary;">**Step 3: Add Webhook URL**</mark>

This is where DoubleTick will send the data.

You can connect it to:

* CRM tools
* Automation tools (Zapier, Pabbly, Make)
* Your backend system

**For testing:**

* Go to **Bot Studio**
* Click **Create New Bot**
* Select trigger → *On Webhook*
* Copy the webhook URL

#### <mark style="color:$primary;">**Step 4: Add Webhook Details**</mark>

* Paste the webhook URL
* Select your API Number (WABA number)
* Click **Continue**

#### <mark style="color:$primary;">**Step 5: Select Event**</mark>

* Select **Tag Removed**
* Click **Create Webhook**

Your webhook is now active.

***

#### <mark style="color:$primary;">**How to Test It**</mark>

Remove a tag from any customer or conversation — or wait for a tag to be removed via bot or workflow

Go to **Bot Studio → Capture Response → View Response Data**

You will see all the removed tag details captured instantly at the exact moment the tag was removed.

***

#### <mark style="color:$primary;">**What Data Do You Receive?**</mark>

| Field      | What It Tells You                                       |
| ---------- | ------------------------------------------------------- |
| from       | The customer’s WhatsApp phone number                    |
| tagId      | Unique ID of the tag that was removed                   |
| tagName    | Name of the tag that was removed                        |
| tagRemoved | Confirms that the tag removal event has occurred (true) |

***

#### <mark style="color:$primary;">**Sample Payload**</mark>

```json
{
  "from": "918291504886",
  "tagId": "tag_i3BrKWJqNA",
  "tagName": "API test",
  "tagRemoved": true
}
```

***

#### <mark style="color:$primary;">**Real-Life Business Use Case: Preventing Wrong Messaging**</mark>

**The Situation**\
A D2C brand runs WhatsApp campaigns like New Offers, Cart Abandonment, and Repeat Purchase, using tags such as Cart Abandoned, Interested, and Converted.

**The Problem**\
Customers who had already purchased were still receiving cart reminders and follow-ups because the **“Cart Abandoned” tag wasn’t removed on time**, leading to poor experience and confusion.

**The Solution**\
With the Tag Removed webhook:

* Customers are instantly removed from irrelevant campaigns
* Moved to the correct segment (e.g., Converted)
* Communication updates automatically

**The Result**

* No irrelevant messages
* Better customer experience
* Improved campaign performance

***

#### <mark style="color:$primary;">**Summary**</mark>

The Tag Removed Webhook ensures your data stays accurate and your communication stays relevant.

It helps you:

* Maintain clean segmentation
* Avoid incorrect messaging
* Automate customer stage transitions

Set it up once — and your system stays in sync automatically.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.doubletick.io/webhooks/how-to-use-tag-removed-webhook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.