---
title: "Update users in bulk"
method: POST
path: "/v4/user-updates"
tags: ["Users"]
---

# Update users in bulk

`POST /v4/user-updates`

Updates user's attributfoes or delete users on a bulk basis. 

When setting attributes, any of the user's existing attributes not specified in the payload will be left in-place.

## Request body

- object
  - `updates` BulkUpdateObject[] — Array of combination of identifier and actions.
    - `identifier` object — Identifier of the user. User either the User ID or Foreign Key.
      - `user_id` string — Unique Id of the user.
      - `foreign_key` object — Foreign key object.
        - `foreign-system` string — The foreign key of the user.
    - `actions` BulkUpdateObjectActionObject[] — The actions to be taken for the user. Available actions are attribute update and user deletion.
      - `type` 'delete-user' | 'set-attribute' — The user update action to be taken.
      - `attribute` object — Details of the attribute update.
        - `field` string, required — The slug of the attribute.
        - `value` string, required — The updated value of the attribute.

## Response `202`

OK

- BulkUserUpdateResponse
  - `message` string — Returned message indicating the status of the operation.
  - `job_id` string — Id of the job.

## Other responses

- `400` — The request is invalid. A required attribute is missing or an attribute did not meet the expected criteria.
- `401` — Authentication credentials were not provided or are invalid.

---

[API](https://skmtc.net/zuora/apis/admin-api-reference.md) · [All operations](https://skmtc.net/zuora/apis/admin-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zuora/admin-api-reference/revisions/789812d35ac8/schema)