> 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-instagram-customer-custom-field-updated-webhook.md).

# How to Use the Instagram Customer Custom Field Updated Webhook

Your team updates customer fields in DoubleTick as conversations progress — marking a lead status, updating a qualification stage, or flagging a customer for follow-up. Each of these updates is a meaningful signal. But without a webhook, that signal stays inside DoubleTick. Your CRM does not know. Your automation does not trigger. Nothing moves.

The Customer Custom Field Updated webhook fires the moment any custom field value changes for an Instagram customer — so your external systems can react to it instantly.

**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 custom field value is set or updated for a customer** on your connected Instagram channel.

***

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

<figure><img src="/files/8W4Md3irNLeYbpZWyTPt" 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 Custom Field Tracker

**Step 3: Get Your Webhook URL**

You need a destination URL — this is where DoubleTick will send the data each time a custom field is updated.

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 Customer Custom Field Updated 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 chat in DoubleTick
2. Update a custom field value for that customer
3. Go to Bot → Capture Response → View Response Data
4. You will see the update captured in real time

***

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

<table><thead><tr><th width="222.53326416015625">Field</th><th>What It Tells You</th></tr></thead><tbody><tr><td><strong>name</strong></td><td>The display name of the custom field that was updated</td></tr><tr><td><strong>value</strong></td><td>The new value that was set for the custom field</td></tr><tr><td><strong>changedAt</strong></td><td>The exact date and time the field was updated</td></tr><tr><td><strong>customerId</strong></td><td>DoubleTick's internal ID for this customer</td></tr><tr><td><strong>wabaNumber</strong></td><td>Will be null for Instagram customers</td></tr><tr><td><strong>dtCustomerId</strong></td><td>DoubleTick's internal unique ID for this customer</td></tr><tr><td><strong>customFieldId</strong></td><td>The unique ID of the custom field that was updated</td></tr><tr><td><strong>customerPhone</strong></td><td>Will be null for Instagram customers</td></tr><tr><td><strong>customerHandle</strong></td><td>The Instagram handle of the customer</td></tr><tr><td><strong>nameOnWhatsapp</strong></td><td>The display name of the customer in DoubleTick</td></tr><tr><td><strong>customFieldType</strong></td><td>The type of the custom field — for example, single_select, text, and so on</td></tr><tr><td><strong>customFieldEventType</strong></td><td>The type of update — ATTRIBUTE_SET means a value was set or changed</td></tr><tr><td><strong>customFieldUniqueName</strong></td><td>The internal unique name of the custom field as configured in DoubleTick</td></tr></tbody></table>

***

#### <mark style="color:$primary;">**Customer Custom Field Updated Webhook – Sample Payload**</mark>

{% code expandable="true" %}

```json
{
  "name": "Abhishek",
  "value": "New",
  "changedAt": "2026-06-16T06:57:33.270Z",
  "customerId": "customer_Ehrc3Ls7kS",
  "wabaNumber": null,
  "dtCustomerId": "customer_Ehrc3Ls7kS",
  "customFieldId": "cf_Be26dKbWy8",
  "customerPhone": null,
  "customerHandle": "abhishxo",
  "nameOnWhatsapp": "Abhishek",
  "customFieldType": "single_select",
  "customFieldEventType": "ATTRIBUTE_SET",
  "customFieldUniqueName": "lead_status"
}
```

{% endcode %}

***

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

The Instagram Customer Custom Field Updated Webhook turns every field update in DoubleTick into a real-time signal your external systems can act on. Set it up once, and any change to a customer's custom field — a lead stage, a qualification status, a priority flag — automatically flows to wherever it needs to go.


---

# 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-instagram-customer-custom-field-updated-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.