How to bulk create Jira Service Management Customers
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
The content on this page relates to platforms which are not supported. Consequently, Atlassian Support cannot guarantee providing any support for it. Please be aware that this material is provided for your information only and using it is done so at your own risk.
Purpose
When migrating from other ITSM tools it is necessary to create users in bulk as part of that migration. This how to guide details how to go about doing that. This approach is targeted for Jira Core 7.1+.
Solution
There is an experimental REST API in Jira Core for creating users, documented at that link. Using this endpoint it is possible to create users with no application keys, and as such they are considered customers. Specifically:
- Ensure mail notification is enabled, as per Configuring JIRA's SMTP mail server to send notifications.
- Write a script to use the create user endpoint.
- When creating users, do not provide them with any application keys.
- Leave the password blank.
- Ensure a notification is sent.
This will create users with no application login and send an email to them to generate a password. Provided a Customer Portal is not configured with restricted access, as detailed in Setting up service project users, they will be able to login to any Customer Portal as a user.
Atlassian Support does not provide support for integration with REST APIs or writing scripts to use them - if you need help please raise a question on Atlassian Answers.