---
title: "Invite customer"
method: POST
path: "/rest/servicedeskapi/servicedesk/{serviceDeskId}/customer/invite"
tags: ["Servicedesk"]
---

# Invite customer

`POST /rest/servicedeskapi/servicedesk/{serviceDeskId}/customer/invite`

This method invites a customer to a specified service desk by sending them an email invitation, creating a new customer account if one does not already exist. 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 & Service desk administrator

## Path parameters

- `serviceDeskId` string, required

## Query parameters

- `strictConflictStatusCode` boolean

## Request body

- ServiceDeskCustomerInviteDTO
  - `displayName` string — Customer's name for display in the UI.
  - `email` string — Customer's email address.

## Response `201`

Returns the customer details.

## Other responses

- `400` — Returned if the request is invalid, either because the display name is empty, or email address is empty or incorrectly formed or already exists in the database if `strictConflictStatusCode=false` or if `strictConflictStatusCode=false` 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.
- `404` — Returned if the servicedesk id does not exist or servicedesk does not belong to a JSM project.
- `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/b062ad697d87/schema)