---
title: "User Tags Data-Rich Webhook"
method: POST
path: "userTagsData"
tags: ["Webhooks"]
---

# User Tags Data-Rich Webhook

`POST userTagsData` (webhook)

Data-rich User Tags webhook. When user tag processing completes, you will receive a POST request with a JSON payload containing the full user tags data directly in the payload.

This webhook type (`USER_TAGS_DATA`) sends the complete user tags results, including all created, deleted, and modified tags with their scores.

Use this webhook type when you want to receive user tag changes directly without needing to fetch them from a separate endpoint.

## Headers

- `X-Webhook-Verification` string

## Payload

- WebhookConfigurationsTestPostUSERTAGSDATA
  - `tenant_id` string — The ID of the tenant for the users included in this update, if they are from a tenant environment.
  - `userTags` object
    - `created` object[] — A list of the new user tags that were generated for this user since the last user tagging update. A full list of the user tags can be accessed [here](https://fingoal.com/tags-list).
      - `user_id` string — The user who received this tag. Corresponds to whatever 'uid' you initially uploaded to the enrichment.
      - `user_tag_id` integer — The ID of the tag that has been applied.
      - `tag_name` string — The name of the tag that has been applied.
    - `deleted` object[] — A list of the user tags that were removed from this user since the last user tagging update.
      - `user_id` string — The user who received this tag. Corresponds to whatever 'uid' you initially uploaded to the enrichment.
      - `user_tag_id` integer — The ID of the tag that has been removed.
      - `tag_name` string — The name of the tag that has been removed.
    - `modified` object[] — For incremental (that is, scored) user tags. Contains all scoring changes for any incremental user tags that have received a score change since the last update.
      - `user_id` string — The user who received this tag. Corresponds to whatever 'uid' you initially uploaded to the enrichment.
      - `user_tag_id` integer — The ID of the tag that has been updated.
      - `tag_name` string — The name of the tag that has been updated.
      - `previous_value` integer — The last value for this tag's score, prior to this update.
      - `new_value` integer — The new value for this tag's score.
      - `delta` integer — The amount by which this tag's score has changed. Can be negative or positive. Will be the difference between the new_value and previous_value fields.

## Acknowledgement `200`

Success

## Other responses

- `201` — Success

---

[API](https://skmtc.dev/fingoal/apis/insights-api.md) · [All operations](https://skmtc.dev/fingoal/apis/insights-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fingoal/insights-api/revisions/00cf4dbd5441/schema)