Jira Cloud: Create a Customer Request
See more Jira Examples
Create a Jira Service Management customer request using a service desk ID, request type ID, and the fields accepted by that portal form. Use request type discovery first. This example assumes summary and description are available and supplies them as strings in requestFieldValues; this is not the platform v3 ADF request format.
Add every additional required field using the schema and valid values returned by request type discovery. The authenticated account must be permitted to create requests in the service desk. Omitting raiseOnBehalfOf creates the request as that account. A successful request creates a real ticket and may send notifications; check for an existing ticket before retrying after an uncertain network outcome.
The code uses an Atlassian account email and an API token without scopes with the site URL. For a scoped API token, keep Basic authentication and change baseUrl to https://api.atlassian.com/ex/jira/YOUR_CLOUD_ID. For OAuth2, use that gateway URL, omit Login/Password/BasicAuth, and set http.AuthToken to the access token. See API token authentication and OAuth2 authorization. The account must have permission for the operation; OAuth scopes do not grant additional Jira permissions.
Targets Jira Cloud. Jira Data Center has a separate REST API and may require different paths, authentication, or payloads.
Atlassian REST API documentation
Chilkat CkJava Downloads
import com.chilkatsoft.*;
public class ChilkatExample {
static {
try {
System.loadLibrary("chilkat");
} catch (UnsatisfiedLinkError e) {
System.err.println("Native code library failed to load.\n" + e);
System.exit(1);
}
}
public static void main(String argv[])
{
boolean success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
CkHttp http = new CkHttp();
http.put_RequireSslCertVerify(true);
http.put_BasicAuth(true);
// Read these credentials from private application configuration.
http.put_Login("YOUR_ATLASSIAN_EMAIL");
http.put_Password("YOUR_API_TOKEN");
String baseUrl = "https://your-domain.atlassian.net";
http.put_Accept("application/json");
CkStringBuilder url = new CkStringBuilder();
CkHttpResponse resp = new CkHttpResponse();
CkJsonObject reply = new CkJsonObject();
CkJsonObject request = new CkJsonObject();
request.UpdateString("serviceDeskId","YOUR_SERVICE_DESK_ID");
request.UpdateString("requestTypeId","YOUR_REQUEST_TYPE_ID");
request.UpdateString("requestFieldValues.summary","Example customer request");
request.UpdateString("requestFieldValues.description","Details of the request.");
url.SetString(baseUrl);
url.Append("/rest/servicedeskapi/request");
success = http.HttpJson("POST",url.getAsString(),request,"application/json",resp);
if (resp.get_StatusCode() == 0) {
System.out.println("No HTTP response was received. Check connectivity and TLS settings.");
return;
}
if ((success != true) || (resp.get_StatusCode() < 200) || (resp.get_StatusCode() >= 300)) {
System.out.println("Request failed. HTTP " + resp.get_StatusCode());
if (resp.get_StatusCode() == 429) {
System.out.println("Rate limited. Retry-After: " + resp.getHeaderField("Retry-After"));
}
// Inspect this response locally; it can contain private Jira data.
System.out.println(resp.bodyStr());
return;
}
success = reply.Load(resp.bodyStr());
if (success != true) {
System.out.println("Expected a JSON object in the response.");
return;
}
if ((reply.JsonTypeOf("issueKey") != 1) || (reply.StringOfEquals("issueKey","",true) == true)) {
System.out.println("Missing value: issueKey");
return;
}
System.out.println("Request: " + reply.stringOf("issueKey"));
System.out.println("Status: " + reply.stringOf("currentStatus.status"));
System.out.println("Portal URL: " + reply.stringOf("_links.web"));
}
}