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

Get Notified the Moment a Tag Is Added to an Instagram Customer

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.

---

When Does This Webhook Trigger?

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

---

Step-by-Step Setup Guide

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.

---

How to Test It

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

---

What Data Do You Receive?

Field	What It Tells You
from	The Instagram handle of the customer — may be empty in some cases
tagId	The unique ID of the tag that was added
tagName	The display name of the tag — for example, New Lead
tagAdded	Will always be true for this event — confirms a tag was added
channelType	Will always be INSTAGRAM
dtCustomerId	DoubleTick's internal unique ID for this customer
customerHandle	The Instagram handle of the customer

---

Instagram Tag Added Webhook – Sample Payload

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

---

Summary

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.