---
title: "Create customer"
method: POST
path: "/rest/servicedeskapi/customer"
tags: ["Customer"]
---

# Create customer

`POST /rest/servicedeskapi/customer`

This method adds a customer to the Jira Service Management instance by passing a JSON file including an email address and display name. The display name does not need to be unique. The record's identifiers, `name` and `key`, are automatically generated from the request details.

**[Permissions](#permissions) required**: Jira Administrator Global permission

## Query parameters

- `strictConflictStatusCode` boolean

## Request body

- CustomerCreateDTO
  - `displayName` string — Customer's name for display in the UI.
  - `email` string — Customer's email address.
  - `fullName` string — Deprecated, please use 'displayName'.

## Response `201`

Returns the customer details.

- UserDTO
  - `_links` UserLinkDTO
    - `avatarUrls` object — Links to the various sizes of the customer's avatar. Note that this property is deprecated, and will be removed in future versions.
    - `jiraRest` string, uri — REST API URL for the customer.
    - `self` string, uri
  - `accountId` string — The accountId of the user, which uniquely identifies the user across all Atlassian products. For example, *5b10ac8d82e05b22cc7d4ef5*.
  - `active` boolean — Indicates if the customer is active (true) or inactive (false)
  - `displayName` string — Customer's name for display in a UI. Depending on the customer’s privacy settings, this may return an alternative value.
  - `emailAddress` string — Customer's email address. Depending on the customer’s privacy settings, this may be returned as null.
  - `key` string — This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details.
  - `name` string — This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details.
  - `timeZone` string — Customer time zone. Depending on the customer’s privacy settings, this may be returned as null.

## Other responses

- `400` — Returned if the request is invalid, either because the email address is incorrectly formed or already exists in the database if `strictConflictStatusCode=false` or if `strictConflictStatusCode` parameter is not provided
- `401` — Returned if the user is not logged in.
- `403` — Returned if the user does not have permission to complete this request.
- `409` — Returned if the request is invalid because the email address already exists in the database and `strictConflictStatusCode=true`
- `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/3cf1fe47664a/schema)