Zendesk

Zendesk Organizations API

The Organizations API from Zendesk — 18 operation(s) for organizations.

Documentation GitHub OpenAPI

Business capability

Operations 24

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v2/organizations/autocomplete Autocomplete organization names by prefix · Zendesk Get Api V2 Organizations Autocomplete #

Ask an LLM

“Can I get organizations whose names start with a few letters I typed, using the v2 autocomplete?”

“What does the v2 organization autocomplete return for a partial name?”

Tell an agent

Suggest organizations whose names begin with the prefix I type, using the v2 autocomplete endpoint.

Run the api/v2 organization name autocomplete for a type-ahead box.

GET /api/v2/organization_merges/{organization_merge_id} Check the status of an organization merge · Zendesk Get Api V2 Organization_merges Organization_merge_id #

Ask an LLM

“Did the organization merge I started finish, and which org won?”

“Where can I see the status and outcome of one specific organization merge?”

Tell an agent

Show the status of the organization merge I kicked off earlier.

Get the winning and losing organization ids for that merge job.

GET /api/v2/organizations List all organizations with cursor pagination · Zendesk Get Api V2 Organizations #

Ask an LLM

“How do I page through every organization in my Zendesk account with cursor pagination?”

“Which organizations can an agent with a custom role see in the v2 list?”

Tell an agent

List every organization in the account using the api/v2 organizations list with cursor pagination.

Page through all organizations 100 at a time from the v2 endpoint.

POST /api/v2/organizations Create an organization · Zendesk Post Api V2 Organizations #

Ask an LLM

“Does each new organization need a unique name when created through api/v2?”

“What happens if two identical organization create calls race each other?”

Tell an agent

Create a new organization with a unique name through the api/v2 organizations endpoint.

Add one organization for our new enterprise customer via the v2 create call.

GET /api/v2/organizations/{organization_id} Get one organization's details · Zendesk Get Api V2 Organizations Organization_id #

Ask an LLM

“How can I look up a single organization's details by its id in the v2 API?”

“What fields come back when I fetch one organization from api/v2?”

Tell an agent

Show organization {organization_id} from the api/v2 organizations endpoint.

Fetch the v2 record for org {organization_id} so I can see its domains and tags.

PUT /api/v2/organizations/{organization_id} Update an organization · Zendesk Put Api V2 Organizations Organization_id #

Ask an LLM

“Will updating an organization's domain_names in v2 overwrite the ones already there?”

“Can an agent without extra permissions change anything besides notes on an organization?”

Tell an agent

Update the notes on organization {organization_id} using the api/v2 PUT.

Replace the domain names on org {organization_id} via the v2 update endpoint.

DELETE /api/v2/organizations/{organization_id} Delete an organization · Zendesk Delete Api V2 Organizations Organization_id #

Ask an LLM

“Who is allowed to delete an organization through the v2 API?”

“Can I remove a single organization by id with an api/v2 DELETE?”

Tell an agent destructive · confirm first

Delete organization {organization_id} through the api/v2 organizations endpoint.

Remove org {organization_id} from Zendesk using the v2 delete call.

POST /api/v2/organizations/{organization_id}/merge Merge one organization into another · Zendesk Post Api V2 Organizations Organization_id Merge #

Ask an LLM

“How do I merge two duplicate organizations and move their users and tickets over?”

“What happens to the losing organization after a merge?”

Tell an agent destructive · confirm first

Merge organization {organization_id} into the winning org, moving its users, tickets and domains.

Fold duplicate org {organization_id} into our main organization and delete the loser.

GET /api/v2/organizations/{organization_id}/merges List merge history for an organization · Zendesk Get Api V2 Organizations Organization_id Merges #

Ask an LLM

“Which merges has an organization been part of, including ones still running?”

“Can I track the history of merge actions on one organization?”

Tell an agent

List all merge operations associated with organization {organization_id}.

Show the ongoing and completed merges for org {organization_id}.

GET /api/v2/organizations/{organization_id}/related Get related counts for an organization · Zendesk Get Api V2 Organizations Organization_id Related #

Ask an LLM

“How many tickets and users are related to an organization?”

“Is there a quick way to see an organization's related information as an agent?”

Tell an agent

Show the related information for organization {organization_id}.

Get ticket and user counts related to org {organization_id}.

GET /api/v2/organizations/count Count organizations in the account · Zendesk Get Api V2 Organizations Count #

Ask an LLM

“About how many organizations do we have in Zendesk?”

“How fresh is the organization count once it passes 100,000?”

Tell an agent

Count the organizations in our account.

Tell me the approximate organization total and when it was last refreshed.

POST /api/v2/organizations/create_many Bulk create up to 100 organizations · Zendesk Post Api V2 Organizations Create_many #

Ask an LLM

“Can I create up to 100 organizations in a single background job?”

“How do I track a bulk organization creation job once it's queued?”

Tell an agent

Bulk create this batch of up to 100 organizations as a background job.

Queue a job that creates all the organizations in my spreadsheet at once.

POST /api/v2/organizations/create_or_update Create or update an organization (upsert) · Zendesk Post Api V2 Organizations Create_or_update #

Ask an LLM

“Is there a way to upsert an organization without checking if it exists first?”

“Do I need an id or external id to update an org through create-or-update?”

Tell an agent

Upsert this organization by external id, creating it if it doesn't exist yet.

Create the organization or update it if one with that id already exists.

DELETE /api/v2/organizations/destroy_many Bulk delete up to 100 organizations · Zendesk Delete Api V2 Organizations Destroy_many #

Ask an LLM

“Can I delete many organizations at once by their ids or external ids?”

“What's the limit on how many organizations one bulk delete can remove?”

Tell an agent destructive · confirm first

Bulk delete these organizations by id in one background job.

Destroy up to 100 organizations listed by external id.

GET /api/v2/organizations/search Search organizations by name or external id · Zendesk Get Api V2 Organizations Search #

Ask an LLM

“How do I find an organization by its external_id using the v2 search?”

“Can I search organizations by name and external id at the same time in api/v2?”

Tell an agent

Search api/v2 organizations for the one matching our CRM account's external id.

Look up an organization by exact name with the v2 organization search.

GET /api/v2/organizations/show_many Get several organizations by id at once · Zendesk Get Api V2 Organizations Show_many #

Ask an LLM

“Can I fetch up to 100 specific organizations in one call by id?”

“Is there a batch lookup for organizations using external ids?”

Tell an agent

Fetch these specific organizations in one request by their ids.

Show many organizations at once using a comma-separated list of external ids.

PUT /api/v2/organizations/update_many Bulk update up to 100 organizations · Zendesk Put Api V2 Organizations Update_many #

Ask an LLM

“How do I apply the same change to many organizations in one request?”

“Can I batch update up to 100 organizations with different changes for each?”

Tell an agent

Bulk update these organizations to add the same tag to all of them.

Batch update up to 100 organizations, each with its own changes.

GET /organizations List organizations with page and per_page · Zendesk List Organizations #

Ask an LLM

“Can I list organizations with simple page and per_page parameters on the /organizations endpoint?”

“How many organizations come back per page if I set per_page on the shorter /organizations path?”

Tell an agent

List organizations from the /organizations endpoint, page {page}.

Get {per_page} organizations per page from the /organizations list.

POST /organizations Create an organization with domains and tags · Zendesk Create Organization #

Ask an LLM

“Can I set domains, tags, notes and custom fields when creating an org via the /organizations endpoint?”

“What's required to create an organization through the plain /organizations POST?”

Tell an agent

Create organization {organization} through the /organizations endpoint.

POST to /organizations to add {organization} with its domains and tags.

GET /organizations/{organization_id} Show an organization from the /organizations path · Zendesk Show Organization #

Ask an LLM

“How do I get one organization's details from the /organizations path by id?”

“Which details does the non-v2 show organization call return?”

Tell an agent

Get organization {organization_id} from the /organizations path.

Show the details of org {organization_id} using the non-v2 endpoint.

PUT /organizations/{organization_id} Update an organization's name, domains or fields · Zendesk Update Organization #

Ask an LLM

“Can I change an organization's name, notes and custom fields via the /organizations PUT?”

“Which organization properties are editable through the non-v2 update?”

Tell an agent

Update organization {organization_id} with {organization} via the /organizations path.

Rename org {organization_id} using the non-v2 update endpoint.

DELETE /organizations/{organization_id} Permanently delete an organization · Zendesk Delete Organization #

Ask an LLM

“If I permanently delete an organization, what happens to its users?”

“Does deleting an org through the /organizations path remove members' organization membership?”

Tell an agent destructive · confirm first

Permanently delete organization {organization_id} using the /organizations path.

Remove org {organization_id} via the non-v2 delete, keeping its users.

GET /organizations/search Find an organization by external id · Zendesk Search Organizations #

Ask an LLM

“Can I pass an external_id query to the /organizations/search path?”

“What does the non-v2 organization search accept?”

Tell an agent

Search /organizations for the org with external id {external_id}.

Find the organization linked to external record {external_id} using the non-v2 search.

GET /organizations/autocomplete Type-ahead organization lookup by name · Zendesk Autocomplete Organizations #

Ask an LLM

“How do I build a type-ahead that suggests organizations from the /organizations/autocomplete path?”

“Which organizations match a name prefix on the non-v2 autocomplete?”

Tell an agent

Autocomplete organizations starting with {name} using the /organizations path.

Suggest orgs whose names begin with {name} for my type-ahead field.

Zendesk Organizations API

Operations 24

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification