# \[Webhooks\] Watching for tag changes to a task

**URL:** <https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574>\
**Category:** API & Developers\
**Tags:** webhooks\
**Created:** [3 March 2021 12:11 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574 "2021-03-03T12:11:10Z")\
**Posts on this page:** 15\
**Page:** 1

<div class="post-metadata">

**Author:** ![Vincent\_Paca](https://luna1.co/8d76cd.png) [@Vincent\_Paca](https://forum.asana.com/u/Vincent_Paca)\
**Post date:** [3 March 2021 12:11 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/1 "2021-03-03T12:11:10Z")

</div>

I created a webhook to watch for changes on a task for the following fields:

- due\_on
- completed
- tags

`due_on` and `completed` triggers the webhook just fine while changes to `tags` do not.

I use the following payload when creating the webhook:

```auto
...
"filters": [
          {
            "action": "changed",
            "fields": ["due_on", "completed", "tags"],
            "resource_type": "task"
          }
        ],
        "resource": "xxx",
        "target": "https://xxxx"
...

```

---

<div class="post-metadata">

**Author:** ![Phil\_Seeman](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/phil_seeman/32/81525_2.png) [@Phil\_Seeman](https://forum.asana.com/u/Phil_Seeman)\
**Post date:** [3 March 2021 17:01 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/2 "2021-03-03T17:01:17Z")

</div>

Hi @Ross_Grambo, are you able to check on this? Are `tags` changes not supported by webhook filtering?

(We still really need a definitive list in the documentation of what parameters work at what filter levels…)

---

<div class="post-metadata">

**Author:** ![Vincent\_Paca](https://luna1.co/8d76cd.png) [@Vincent\_Paca](https://forum.asana.com/u/Vincent_Paca)\
**Post date:** [4 March 2021 03:53 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/3 "2021-03-04T03:53:42Z")

</div>

> [@Phil\_Seeman](#):
>
> (We still really need a definitive list in the documentation of what parameters work at what filter levels…)

This one would really be amazing.

I have tested this in different ways and it does seem that tags don’t get triggered at least watching for the “changed” action.

What would be the alternative to watch for tag changes in a task?

---

<div class="post-metadata">

**Author:** ![Phil\_Seeman](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/phil_seeman/32/81525_2.png) [@Phil\_Seeman](https://forum.asana.com/u/Phil_Seeman)\
**Post date:** [4 March 2021 20:35 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/4 "2021-03-04T20:35:46Z")

</div>

> [@Vincent\_Paca](#):
>
> What would be the alternative to watch for tag changes in a task?

You would need to catch all changes to a task and store the returned tags in your own data store; then when you received another change for that task, compare its tags to the ones you stored to see if anything has changed.

---

<div class="post-metadata">

**Author:** ![Vincent\_Paca](https://luna1.co/8d76cd.png) [@Vincent\_Paca](https://forum.asana.com/u/Vincent_Paca)\
**Post date:** [5 March 2021 01:41 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/5 "2021-03-05T01:41:41Z")

</div>

How do I watch for _any_ change in a task? Is that possible to do without having the fields filter?

In my current setup, I can watch for changes on the tags if someone touches the `due_on` or `completed` fields on a task, but if they _only_ change the tag, it won’t trigger the webhook.

---

<div class="post-metadata">

**Author:** ![Phil\_Seeman](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/phil_seeman/32/81525_2.png) [@Phil\_Seeman](https://forum.asana.com/u/Phil_Seeman)\
**Post date:** [5 March 2021 05:01 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/6 "2021-03-05T05:01:18Z")

</div>

> [@Vincent\_Paca](#):
>
> How do I watch for _any_ change in a task?

Just leave out the `fields` filter in your request and you’ll get all changes on that task.

---

<div class="post-metadata">

**Author:** ![Vincent\_Paca](https://luna1.co/8d76cd.png) [@Vincent\_Paca](https://forum.asana.com/u/Vincent_Paca)\
**Post date:** [6 March 2021 08:06 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/7 "2021-03-06T08:06:36Z")

</div>

Wow! Didn’t know you can do this one. Thanks, will give it a try!

---

<div class="post-metadata">

**Author:** ![Vincent\_Paca](https://luna1.co/8d76cd.png) [@Vincent\_Paca](https://forum.asana.com/u/Vincent_Paca)\
**Post date:** [6 March 2021 08:50 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/8 "2021-03-06T08:50:33Z")

</div>

I have tried this and while it does watch for certain changes on the task, it does not trigger the webhook on a tag change (adding, removing). Was really hoping that was the fix I was looking for.

It’s totally possible that tags are not being listened to for changes, right? Do you think there’s still a way around this?

---

<div class="post-metadata">

**Author:** ![Phil\_Seeman](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/phil_seeman/32/81525_2.png) [@Phil\_Seeman](https://forum.asana.com/u/Phil_Seeman)\
**Post date:** [6 March 2021 14:17 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/9 "2021-03-06T14:17:05Z")

</div>

> [@Vincent\_Paca](#):
>
> it does not trigger the webhook on a tag change (adding, removing).

That’s very, very weird.

Are you setting the webhook at the **task** level, I guess? I’ve never used task-level webhooks, I only use **project** -level webhooks (and above), but I can say with 100.00% certainty that setting a project-level webhook will generate an event when a tag is added/modified on any task in that project.

Can you try setting a project-level webhook just to confirm that you then get the webhook events on tag changes? Because if you don’t, then something is up with your implementation; and if you do, then that would confirm an important finding about differences between project-level and task-level webhooks that would surprise me.

---

<div class="post-metadata">

**Author:** ![Vincent\_Paca](https://luna1.co/8d76cd.png) [@Vincent\_Paca](https://forum.asana.com/u/Vincent_Paca)\
**Post date:** [7 March 2021 09:19 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/10 "2021-03-07T09:19:44Z")

</div>

Thanks for your responses Phil, really appreciate your help. It’s a shame the Webhook section isn’t so well documented.

I have created a webhook at a project level and it’s still not working for me. What’s even worse is it doesn’t listen for any changes at all. There probably is something wrong with how I’m creating this webhook. I really just create a webhook that listens for changes on the project. This is the payload I send:

```
{
  "data": {
    "filters": [
      {
        "action": "changed",
        "resource_type": "project"
      }
    ],
    "resource": "<project_gid">,
    "target": "https://my.endpoint"
  }
}

```

What am I missing here?

---

<div class="post-metadata">

**Author:** ![Phil\_Seeman](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/phil_seeman/32/81525_2.png) [@Phil\_Seeman](https://forum.asana.com/u/Phil_Seeman)\
**Post date:** [7 March 2021 15:08 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/11 "2021-03-07T15:08:00Z")

</div>

Remove the `filters` section entirely.

---

<div class="post-metadata">

**Author:** ![Ross\_Grambo](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/ross_grambo/32/68568_2.png) [@Ross\_Grambo](https://forum.asana.com/u/Ross_Grambo)\
**Post date:** [9 March 2021 00:41 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/12 "2021-03-09T00:41:21Z")

</div>

Sorry for being late to this thread, but I agree with Phil. Try:

```auto
{
  "data": {
    "resource": "<project_gid">,
    "target": "https://my.endpoint"
  }
}

```

---

<div class="post-metadata">

**Author:** ![Info7](https://luna1.co/8d76cd.png) [@Info7](https://forum.asana.com/u/Info7)\
**Post date:** [1 July 2021 10:57 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/13 "2021-07-01T10:57:48Z")

</div>

I got events of changing tags, but I created webhook with “added” filter on a project and when I add tags to a task or subtask I got events like this one, It looks like I added a task, but I didn’t, I just I added a tag to a task.  
event:{  
“user”: {  
“gid”: “”,  
“resource\_type”: “user”  
},  
“action”: “added”,  
“resource”: {  
“gid”: “”,  
“resource\_type”: “task”,  
“resource\_subtype”: “default\_task”  
},  
“parent”: {  
“gid”: “”,  
“resource\_type”: “tag”  
}  
}  
Hope this will help

---

<div class="post-metadata">

**Author:** ![Phil\_Seeman](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/phil_seeman/32/81525_2.png) [@Phil\_Seeman](https://forum.asana.com/u/Phil_Seeman)\
**Post date:** [1 July 2021 16:40 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/14 "2021-07-01T16:40:35Z")

</div>

Hi @Info7,

Yeah, that’s the way Asana events work. As [the documentation says](https://developers.asana.com/docs/get-events-on-a-resource):

> _Note: The resource returned will be the resource that triggered the event._

In this case, the task is the resource that’s being monitored for changes, and when the API sees that a change occurred that you’re asking about - in your case adding a tag - that task triggers the event.

---

<div class="post-metadata">

**Author:** ![system](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/system/32/276370_2.png) [@system](https://forum.asana.com/u/system)\
**Post date:** [30 May 2025 19:05 UTC](https://forum.asana.com/t/webhooks-watching-for-tag-changes-to-a-task/112574/15 "2025-05-30T19:05:28Z")

</div>

Closed on 30 May 2025 19:05 UTC


