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

# Invite customer

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

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/{serviceDeskId}/customer/invite`
- Auth: OAuth 2
  - Authorization code: `https://auth.atlassian.com/authorize`
  - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `manage:servicedesk-customer`

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.

## Changes

> 20 revisions in range; 3 not diffed.

- **2026-07-13** `bba7b3477d98`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/changes/rest/servicedeskapi/servicedesk/:serviceDeskId/customer/invite/post.md)

---

[API](https://skmtc.dev/atlassian/apis/service-management-public-rest-api.md) - [All operations](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/revisions/fe02b1260fc7?raw)