Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zendesk Organizations API

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

Zendesk Organizations API is one of 150 APIs that Zendesk publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Organizations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 2 JSON Schemas.

This API exposes 24 operations across 18 paths, and defines 11 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against the base URL https://{subdomain}.zendesk.com.

24 operations 18 paths 11 schemas 3 DELETE13 GET5 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Base URL
https://{subdomain}.zendesk.com
Resource Areas
1

Paths & Operations 24

Across 18 paths, the API surfaces 24 operations — 3 DELETE, 13 GET, 5 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

Organizations 24
GET
/api/v2/organizations/autocomplete
Zendesk Get Api V2 Organizations Autocomplete
AutocompleteOrganizations 3 params → 200400429500
GET
/api/v2/organization_merges/{organization_merge_id}
Zendesk Get Api V2 Organizationmerges Organizationmergeid
ShowOrganizationMerge 1 param → 200
GET
/api/v2/organizations
Zendesk Get Api V2 Organizations
ListOrganizations → 200
POST
/api/v2/organizations
Zendesk Post Api V2 Organizations
CreateOrganization body → 201
GET
/api/v2/organizations/{organization_id}
Zendesk Get Api V2 Organizations Organizationid
ShowOrganization 1 param → 200
PUT
/api/v2/organizations/{organization_id}
Zendesk Put Api V2 Organizations Organizationid
UpdateOrganization 1 param → 200429
DELETE
/api/v2/organizations/{organization_id}
Zendesk Delete Api V2 Organizations Organizationid
DeleteOrganization 1 param → 204
POST
/api/v2/organizations/{organization_id}/merge
Zendesk Post Api V2 Organizations Organizationid Merge
CreateOrganizationMerge 1 param body → 200
GET
/api/v2/organizations/{organization_id}/merges
Zendesk Get Api V2 Organizations Organizationid Merges
ListOrganizationMerges 1 param → 200
GET
/api/v2/organizations/{organization_id}/related
Zendesk Get Api V2 Organizations Organizationid Related
OrganizationRelated 1 param → 200
GET
/api/v2/organizations/count
Zendesk Get Api V2 Organizations Count
CountOrganizations → 200
POST
/api/v2/organizations/create_many
Zendesk Post Api V2 Organizations Createmany
CreateManyOrganizations → 200
POST
/api/v2/organizations/create_or_update
Zendesk Post Api V2 Organizations Createorupdate
CreateOrUpdateOrganization → 200201
DELETE
/api/v2/organizations/destroy_many
Zendesk Delete Api V2 Organizations Destroymany
DeleteManyOrganizations 2 params → 200
GET
/api/v2/organizations/search
Zendesk Get Api V2 Organizations Search
SearchOrganizations 2 params → 200
GET
/api/v2/organizations/show_many
Zendesk Get Api V2 Organizations Showmany
ShowManyOrganizations 2 params → 200
PUT
/api/v2/organizations/update_many
Zendesk Put Api V2 Organizations Updatemany
UpdateManyOrganizations 2 params → 200
GET
/organizations
Zendesk List Organizations
listOrganizations 2 params → 200401429
POST
/organizations
Zendesk Create Organization
createOrganization body → 201401422429
GET
/organizations/{organization_id}
Zendesk Show Organization
getOrganization 1 param → 200401404429
PUT
/organizations/{organization_id}
Zendesk Update Organization
updateOrganization 1 param body → 200401404422429
DELETE
/organizations/{organization_id}
Zendesk Delete Organization
deleteOrganization 1 param → 204401404429
GET
/organizations/search
Zendesk Search Organizations
searchOrganizations 1 param → 200401429
GET
/organizations/autocomplete
Zendesk Autocomplete Organizations
autocompleteOrganizations 1 param → 200401429

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are Organization (14 properties), OrganizationCreate (10 properties), OrganizationUpdate (10 properties), OrganizationsResponse (4 properties). Each schema is shown below with its type and property counts.

OrganizationResponse
object
1 property
OrganizationsResponse
object
4 properties
OrganizationMergeResponse
object
1 property
OrganizationMergeListResponse
object
1 property
OrganizationCreate
object
Payload for creating a new organization.
10 properties 1 required
JobStatusResponse
object
1 property
Organization
object
A Zendesk organization representing a company or group of users.
14 properties
CountOrganizationResponse
object
1 property
Error
object
An error response from the Zendesk API.
3 properties
OrganizationUpdate
object
Payload for updating an existing organization.
10 properties
OrganizationsRelatedResponse
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zendesk-organizations-api-openapi.yml Raw ↑

Other APIs Zendesk publishes across the network.

Zendesk Help Center Articles API
Zendesk Help Center Sections API
Zendesk Help Center Categories API
Zendesk Help Center Translations API
Zendesk Help Center Article Attachments API
Zendesk Help Center Article Comments API
Zendesk Help Center Article Labels API
Zendesk Help Center Topics API
Zendesk Help Center Posts API
Zendesk Help Center Post Comments API
Zendesk Help Center Votes API
Zendesk Help Center Content Subscriptions API