---
title: "Create organization"
method: POST
path: "/rest/servicedeskapi/organization"
tags: ["Organization"]
---

# Create organization

`POST /rest/servicedeskapi/organization`

This method creates an organization by passing the name of the organization.

**[Permissions](#permissions) required**: Service desk administrator or agent. Note: Permission to create organizations can be switched to users with the Jira administrator permission, using the **[Organization management](https://confluence.atlassian.com/servicedeskcloud/setting-up-service-desk-users-732528877.html#Settingupservicedeskusers-manageorgsManageorganizations)** feature.

## Request body

- OrganizationCreateDTO
  - `name` string, required — Name of the organization. Must contain 1-200 characters.

## Response `201`

Returns the created organization or the existing organization if name already exists.

- OrganizationDTO
  - `_links` SelfLinkDTO
    - `self` string, uri
  - `created` DateDTO
    - `epochMillis` integer — Date as the number of milliseconds that have elapsed since 00:00:00 Coordinated Universal Time (UTC), 1 January 1970.
    - `friendly` string — Date in a user-friendly text format.
    - `iso8601` string — Date in ISO8601 format.
    - `jira` string — Date in the format used in the Jira REST APIs, which is ISO8601 format but extended with milliseconds. For example, 2016-09-28T23:08:32.097+1000.
  - `id` string — A unique system generated ID for the organization.
  - `name` string — Name of the organization.
  - `scimManaged` boolean — Returns if an organization is managed by scim. This field may not be present in some older organizations
  - `uuid` string — A unique system generated ID for the organization. This is identity from the group directory id

## Other responses

- `400` — Returned if the HTTP request is invalid.
- `401` — Returned if the user is not logged in.
- `403` — Returned if the user does not have permission to complete this request.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/atlassian/apis/service-management-public-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/service-management-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/service-management-public-rest-api/revisions/8fd2ad4c779b/schema)