Sign in
Organizations

Create Organization

You must provide a unique name for each organization. Normally the system doesn't allow records to be created with identical names. However, a race condition can occur if you make two or more identical POSTs very close to each other, causing the records to have identical organization names.

Allowed For

  • Admins
  • Agents assigned to a custom role with permissions to manage organizations (Enterprise only)
post/api/v2/organizations

Request body

Example request

{
  "organization": {
    "created_at": "2009-07-20T22:55:29Z",
    "details": "This is a kind of organization",
    "domain_names": [
      "example.com",
      "test.com"
    ],
    "external_id": "ABC123",
    "group_id": null,
    "id": 35436,
    "name": "One Organization",
    "notes": "",
    "organization_fields": {
      "org_decimal": 5.2,
      "org_dropdown": "option_1"
    },
    "shared_comments": true,
    "shared_tickets": true,
    "tags": [
      "enterprise",
      "other_tag"
    ],
    "updated_at": "2011-05-05T10:38:52Z",
    "url": "https://company.zendesk.com/api/v2/organizations/35436.json"
  }
}

Response

Created

Example response

{
  "organization": {
    "created_at": "2009-07-20T22:55:29Z",
    "details": "This is a kind of organization",
    "domain_names": [
      "example.com",
      "test.com"
    ],
    "external_id": "ABC123",
    "group_id": null,
    "id": 35436,
    "name": "One Organization",
    "notes": "",
    "organization_fields": {
      "org_decimal": 5.2,
      "org_dropdown": "option_1"
    },
    "shared_comments": true,
    "shared_tickets": true,
    "tags": [
      "enterprise",
      "other_tag"
    ],
    "updated_at": "2011-05-05T10:38:52Z",
    "url": "https://company.zendesk.com/api/v2/organizations/35436.json"
  }
}

Changes