Create Or Update Many Users
POST {{baseUrl}}/api/v2/users/create_or_update_many
Accepts an array of up to 100 user objects. For each user, the user is created if it does not already exist, or the existing user is updated.
Each individual user object can identify an existing user by email
or by external_id
.
This endpoint returns a job_status
JSON object and queues a background job to do the work.
Use the Show Job Status endpoint to check for the job's completion.
Allowed For
- Agents, with restrictions on certain actions
Request Body
{"users"=>[{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, {"value"=>"<Error: Too many levels of nesting to fake this schema>"}]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"job_status":{"id":"82de0b044094f0c67893ac9fe64f1a99","message":"Completed at 2018-03-08 10:07:04 +0000","progress":2,"results":[{"action":"update","id":244,"status":"Updated","success":true},{"action":"update","id":245,"status":"Updated","success":true}],"status":"completed","total":2,"url":"https://example.zendesk.com/api/v2/job_statuses/82de0b0467893ac9fe64f1a99.json"}}