Update Many Organizations

PUT {{baseUrl}}/api/v2/organizations/update_many?ids=<string>&external_ids=<string>

Bulk or batch updates up to 100 organizations.

Bulk update

To make the same change to multiple organizations, use the following endpoint and data format:

https://{subdomain}.zendesk.com/api/v2/organizations/update_many.json?ids=1,2,3

{
  "organization": {
    "notes": "Priority"
  }
}

Batch update

To make different changes to multiple organizations, use the following endpoint and data format:

https://{subdomain}.zendesk.com/api/v2/organizations/update_many.json

{
  "organizations": [
    { "id": 1, "notes": "Priority" },
    { "id": 2, "notes": "Normal" }
  ]
}

Response

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

  • Admins
  • Agents

Agents with no permissions restrictions can only update notes on organizations.

Request Params

KeyDatatypeRequiredDescription
idsstringA list of organization ids
external_idsstringA list of external ids

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;job_status&quot;:{&quot;id&quot;:&quot;8b726e606741012ffc2d782bcb7848fe&quot;,&quot;message&quot;:&quot;Completed at Fri Apr 13 02:51:53 +0000 2012&quot;,&quot;progress&quot;:2,&quot;results&quot;:[{&quot;action&quot;:&quot;update&quot;,&quot;id&quot;:380,&quot;status&quot;:&quot;Updated&quot;,&quot;success&quot;:true}],&quot;status&quot;:&quot;completed&quot;,&quot;total&quot;:2,&quot;url&quot;:&quot;https://company.zendesk.com/api/v2/job_statuses/8b726e606741012ffc2d782bcb7848fe.json&quot;}}