PUT /api/v2/users/update_many

Update Many Users

Servers

https://{subdomain}.{domain}.com

Request headers

Name	Type	Required	Description
`Content-Type`	String	Yes	The media type of the request body. Default value: "application/json"

Query parameters

Name Type Required Description

Name	Type	Required	Description
`external_ids`	String	No	External Id of the users to update. Comma separated
`brand_id`	Integer	No	Scopes the bulk update of users matched by `external_ids` to a specific brand or to account-scoped (brand-less) users. Only applicable when the account has brand separation enabled (`brand_user_separation_eap`). Ignored otherwise so existing numeric callers continue to behave as before. Accepted values: 0 — restrict the lookup to account-scoped (brand-less) users only. A numeric brand id — restrict to that brand. Brands without `user_separation` enabled collapse to account scope (0). Rejected with "400 Bad Request": "all" — cross-brand bulk update is not supported on this endpoint. Any other non-numeric string. A numeric brand id that does not exist on the account. Combining `brand_id` with `ids` (use `external_ids` instead — `ids` are globally unique so brand scoping is meaningless). When `external_ids` is provided without `brand_id`, the request defaults to account scope (0).
`ids`	String	No	Id of the users to update. Comma separated

external_ids

String

External Id of the users to update. Comma separated

brand_id

Integer

Scopes the bulk update of users matched by external_ids to a specific brand or to account-scoped (brand-less) users. Only applicable when the account has brand separation enabled (brand_user_separation_eap). Ignored otherwise so existing numeric callers continue to behave as before.

Accepted values:

0 — restrict the lookup to account-scoped (brand-less) users only.
A numeric brand id — restrict to that brand. Brands without user_separation enabled collapse to account scope (0).

Rejected with "400 Bad Request":

"all" — cross-brand bulk update is not supported on this endpoint.
Any other non-numeric string.
A numeric brand id that does not exist on the account.
Combining brand_id with ids (use external_ids instead — ids are globally unique so brand scoping is meaningless).

When external_ids is provided without brand_id, the request defaults to account scope (0).

ids

String

Id of the users to update. Comma separated

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.