---
title: "User custom field values updated"
method: POST
path: "user.customfield.values.updated"
tags: ["User"]
---

# User custom field values updated

`POST user.customfield.values.updated` (webhook)

Sent to your endpoint when the custom field values of one or several users change in your platform. The users are sent by batch, so a single change can reach your endpoint as several events. Deleting a custom field does not trigger this event, even though it removes all its values from users: listen to the `user.customfield.deleted` event to cover that case.

## Headers

- `webhook-signature` string, required
- `webhook-id` string, required
- `webhook-timestamp` string, required

## Payload

- object
  - `type` 'user.customfield.values.updated', required: The type of the event.
  - `timestamp` integer, required: The date and time when the event was triggered in your platform, in the Unix epoch format (number of milliseconds that have elapsed since January 1, 1970).
  - `data` UserCustomFieldValuesUpdatedDTO, required
    - `users` UserWithUpdatedCustomFieldValuesDTO[], required: The users whose custom field values changed.
      - `userId` string, ObjectId, required: The unique ID of the user.
      - `changedAt` string, date-time, required: The date and time when the values of this user were changed, in the `YYYY-MM-DDThh:mm:ss.sssZ` format (ISO 8601 in Coordinated Universal Time (UTC)).
      - `fields` UserCustomFieldValueDTO[], required: The custom fields whose values changed for this user. The custom fields left untouched are not listed.
        - `customFieldId` string, ObjectId, required: The unique ID of the custom field.
        - `customFieldName` string, required: The name of the custom field.
        - `customFieldType` 'string' | 'date', required: The type of the custom field. Options are: - `string`: the field holds a text value. - `date`: the field holds an ISO 8601 date value.
        - `values` string[], required: The complete set of values held by the custom field after the change. It replaces the values you previously received for this field, and is empty when the field is no longer set.

## Acknowledgement `2XX`

The event is considered as accepted for any 2xx response code.

## Other responses

- `default`: The event is considered as rejected for any other response code. The event emission will be retried later.

---

[API](https://skmtc.dev/360learning/apis/webhook-api.md) - [All operations](https://skmtc.dev/360learning/apis/webhook-api/llms.txt) - [OpenAPI document](https://skmtc.dev/360learning/apis/webhook-api/revisions/c2110549e263?raw)