This guide provides steps to integrate Mavenoid with Jira Service Cloud, enabling customer request creation through Jira’s REST APIs with Basic or OAuth 2.0 authentication.

Requirements

• Admin Access To Mavenoid: Contact your Mavenoid representative if you lack admin permissions.

• API Credentials: Jira username and API token or OAuth 2.0 credentials for an OAuth 2.0 app.

Authentication Methods

• Basic Authentification: Create a user and generate an API token with permissions to create service requests. For more details, refer to Jira's Basic auth for REST APIs guide.

• OAuth 2.0 Authentication: Register an OAuth app in Jira with write:servicedesk-request and offline_access scopes. For more details, refer to Jira's OAuth 2.0 (3LO) apps guide.

Integration Steps

1. Choose Authentication Method:

   • Basic Authentication: Store the base64-encoded user_email:api_token as a secret in Mavenoid, and add it to API requests with the header Authorization: Basic {{$secrets["YOUR_SECRET"]}}.

   • OAuth 2.0 Authentication: Obtain an access token through Jira’s OAuth flow. Use this in API requests by setting Authorization: Bearer {{ACCESS_TOKEN}} in the request header.

2. Create a Customer Request:
   Use Call External API action to submit a POST request to https://{YOUR_JIRA_DOMAIN}.atlassian.net/rest/servicedeskapi/request. Include serviceDeskId and requestTypeId in the request body to ensure correct routing.
    
   For details on how to find the serviceDeskId and requestTypeId, refer to Jira's community thread How to find serviceDeskId and requestTypeId.
    
   For further details on creating customer requests, see Jira’s Create customer request documentation.