> For the complete documentation index, see [llms.txt](https://learn.doubletick.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.doubletick.io/webhooks/how-to-use-the-webhook-for-tags-added-to-an-instagram-conversation.md).

# How to Use the Webhook for Tags Added to an Instagram Conversation

Tags in DoubleTick are how your team categorises customers — New Lead, High Priority, Follow Up, Interested, Not Reachable, and so on. Every time an agent adds a tag, it means something has changed about that customer. But without a webhook, that change stays inside DoubleTick. Your CRM does not update. Your automation does not fire. The signal is lost.

The Tag Added webhook fires the moment any tag is added to an Instagram customer — so your external systems can act on it immediately.

**Note: This webhook is only available for organisations that have an Instagram channel connected in DoubleTick.**

***

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

This webhook fires every time **a tag is added to a customer** on your connected Instagram channel.

***

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

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

**Step 1: Open Webhooks in DoubleTick**

1. Log in to your DoubleTick account
2. Go to Settings
3. Click on Webhooks

**Step 2: Create a New Webhook**

1. Click New Webhook
2. Give it a name — for example: Instagram Tag Added Tracker

**Step 3: Get Your Webhook URL**

You need a destination URL — this is where DoubleTick will send the data each time a tag is added.

For testing, use DoubleTick's Bot Studio to preview the incoming data first:

1. Open a new tab and go to Bot Studio
2. Click Create New Bot
3. Set the trigger to On Webhook
4. Copy the webhook URL that appears

**Step 4: Fill in Webhook Details**

1. Go back to the Webhooks page
2. Enter the webhook name
3. Paste the webhook URL
4. Under Channel Type, select Instagram
5. Select your Instagram channel
6. Click Continue

**Step 5: Choose the Event**

1. Select Tag Added from the event list
2. Click Save

Your webhook is now active.

***

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

1. Open any Instagram customer's profile in DoubleTick
2. Add a tag to that customer
3. Go to Bot → Capture Response → View Response Data
4. You will see the tag event captured in real time

***

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

<table><thead><tr><th width="162.7999267578125">Field</th><th>What It Tells You</th></tr></thead><tbody><tr><td><strong>from</strong></td><td>The Instagram handle of the customer — may be empty in some cases</td></tr><tr><td><strong>tagId</strong></td><td>The unique ID of the tag that was added</td></tr><tr><td><strong>tagName</strong></td><td>The display name of the tag — for example, New Lead</td></tr><tr><td><strong>tagAdded</strong></td><td>Will always be true for this event — confirms a tag was added</td></tr><tr><td><strong>channelType</strong></td><td>Will always be INSTAGRAM</td></tr><tr><td><strong>dtCustomerId</strong></td><td>DoubleTick's internal unique ID for this customer</td></tr><tr><td><strong>customerHandle</strong></td><td>The Instagram handle of the customer</td></tr></tbody></table>

***

#### <mark style="color:$primary;">**Instagram Tag Added Webhook – Sample Payload**</mark>

```json
{
  "from": "",
  "tagId": "tag_nbZehlxXYp",
  "tagName": "New Lead",
  "tagAdded": true,
  "channelType": "INSTAGRAM",
  "dtCustomerId": "customer_Ehrc3Ls7kS",
  "customerHandle": "abhishxo"
}
```

***

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

The Instagram Tag Added Webhook turns every tag your team applies in DoubleTick into a real-time trigger for your external systems. Set it up once, and every tag becomes an automated signal that moves the right customer to the right stage in your workflow — instantly.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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-the-webhook-for-tags-added-to-an-instagram-conversation.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.