> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira Service Management

> How to set up the Jira Service Management connector, plus the actions and events that are available.

![Jira Service Management](https://stackone-logos.com/api/jira-service-management/filled/svg)

v1.2.0[See changelog](https://docs.stackone.com/connectors/jiraservicemanagement/changelog.md)

[42 actions](#actions) · [17 events](#events) · 2 auth methods

ITSM
Ticketing

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/jiraservicemanagement/guides/connector-profile/oauth-2-0.md)
>
> Requires registering an OAuth app in the Atlassian Developer Console. Supports granular scopes for service desk requests...

> [card] [API Token · Connector Profile](https://docs.stackone.com/connectors/jiraservicemanagement/guides/connector-profile/api-token.md)
>
> Best for personal scripts and single-user automation. Uses email + API token for basic authentication.

Optionally, configure receiving Events for Jira Service Management into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/jiraservicemanagement/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/jiraservicemanagement/guides/link-account/oauth-2-0.md)

> [card] [API Token · Link Account](https://docs.stackone.com/connectors/jiraservicemanagement/guides/link-account/api-token.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

API Token

OAuth 2.0

No auth methods found

Scopes

Select all
|
Clear

manage:servicedesk-customer

read:queue:jira-service-management

read:request.sla:jira-service-management

read:servicedesk-request

write:request.status:jira-service-management

write:servicedesk-request

No scopes found

42 actions

ActionDescriptionRequired scopes

List Request Approvals`jiraservicemanagement_list_request_approvals`

Get all approvals on a customer request

`read:servicedesk-request`

List Request Comments`jiraservicemanagement_list_request_comments`

Get all comments on a customer request

`read:servicedesk-request`

Get Request Comment`jiraservicemanagement_get_request_comment`

Get a specific comment on a customer request

`read:servicedesk-request`

Create Request Comment`jiraservicemanagement_create_request_comment`

Create a public or internal comment on a request

`write:servicedesk-request`

List Service Desk Customers`jiraservicemanagement_list_service_desk_customers`

Get customers associated with a service desk

`manage:servicedesk-customer`

Add Customers To Service Desk`jiraservicemanagement_add_service_desk_customers`

Add customers to a service desk

`manage:servicedesk-customer`

Create Customer`jiraservicemanagement_create_customer`

Create a new customer account

`manage:servicedesk-customer`

Get Request Feedback`jiraservicemanagement_get_request_feedback`

Get customer satisfaction feedback for a request

`read:servicedesk-request`

Post Request Feedback`jiraservicemanagement_post_request_feedback`

Submit customer satisfaction feedback for a resolved request. Requires rating (1-5), type must be set to "csat", and com...

`write:servicedesk-request`

Delete Request Feedback`jiraservicemanagement_delete_request_feedback`

Delete customer satisfaction feedback from a request

`write:servicedesk-request`

Get Info`jiraservicemanagement_get_info`

Get runtime information about the JSM instance

List All Organizations (Global)`jiraservicemanagement_list_organizations`

Get all organizations across the entire Jira instance. For organizations linked to a specific service desk, use list\_ser...

`manage:servicedesk-customer`

Create Organization`jiraservicemanagement_create_organization`

Create a new organization

`manage:servicedesk-customer`

Get Organization`jiraservicemanagement_get_organization`

Get a specific organization by ID

`manage:servicedesk-customer`

Delete Organization`jiraservicemanagement_delete_organization`

Delete an organization

`manage:servicedesk-customer`

List Organization Users`jiraservicemanagement_list_organization_users`

Get all users in an organization

`manage:servicedesk-customer`

Add Users To Organization`jiraservicemanagement_add_organization_users`

Add users to an organization. Pass accountIds as an array of Atlassian account ID strings. Use list\_organization\_users t...

`manage:servicedesk-customer`

Remove Users From Organization`jiraservicemanagement_remove_organization_users`

Remove users from an organization. Pass accountIds as an array of Atlassian account ID strings. Use list\_organization\_us...

`manage:servicedesk-customer`

List Organizations For Service Desk`jiraservicemanagement_list_service_desk_organizations`

Get organizations linked to a specific service desk. Requires a serviceDeskId. Use list\_service\_desks to find the servic...

`manage:servicedesk-customer`

Add Organization To Service Desk`jiraservicemanagement_add_service_desk_organization`

Add an organization to a service desk

`manage:servicedesk-customer`

Remove Organization From Service Desk`jiraservicemanagement_remove_service_desk_organization`

Remove an organization from a service desk

`manage:servicedesk-customer`

List Request Participants`jiraservicemanagement_list_request_participants`

Get all participants on a customer request

`read:servicedesk-request`

Add Request Participants`jiraservicemanagement_add_request_participants`

Add participants to a customer request

`write:servicedesk-request`

Remove Request Participants`jiraservicemanagement_remove_request_participants`

Remove participants from a customer request

`write:servicedesk-request`

List Queues`jiraservicemanagement_list_queues`

Get all queues for a service desk

`read:queue:jira-service-management`

Get Queue`jiraservicemanagement_get_queue`

Get a specific queue by ID

`read:queue:jira-service-management`

List Queue Issues`jiraservicemanagement_list_queue_issues`

Get issues in a specific queue

`read:queue:jira-service-management`

List Customer Requests`jiraservicemanagement_list_customer_requests`

Get all customer requests accessible to the user

`read:servicedesk-request`

Get Request`jiraservicemanagement_get_customer_request`

Get a specific customer request by issue ID or key

`read:servicedesk-request`

Create Request`jiraservicemanagement_create_customer_request`

Create a new customer request in a service desk. Use list\_service\_desks to get serviceDeskId, list\_service\_desk\_request\_...

`write:servicedesk-request`

List All Request Types (Global)`jiraservicemanagement_list_request_types`

Get all request types across all service desks globally. Use this when you need request types from every service desk at...

`read:servicedesk-request`

List Request Types For Service Desk`jiraservicemanagement_list_service_desk_request_types`

Get all request types available on a specific service desk. Requires a serviceDeskId. Use list\_service\_desks to find the...

`read:servicedesk-request`

Get Request Type`jiraservicemanagement_get_request_type`

Get a specific request type by ID on a service desk. Requires both serviceDeskId and requestTypeId. Use list\_service\_des...

`read:servicedesk-request`

Get Request Type Fields`jiraservicemanagement_get_request_type_fields`

Get the fields for a specific request type

`read:servicedesk-request`

List Request Type Groups`jiraservicemanagement_list_request_type_groups`

Get request type groups for a service desk

`read:servicedesk-request`

List Service Desks`jiraservicemanagement_list_service_desks`

Get all service desks accessible to the user

`read:servicedesk-request`

Get Service Desk`jiraservicemanagement_get_service_desk`

Get a specific service desk by ID

`read:servicedesk-request`

List All SLA Metrics`jiraservicemanagement_list_request_sla_information`

Get all SLA metric records for a customer request. Returns each SLA metric ID, name, and cycle details. Use a returned s...

`read:request.sla:jira-service-management`

Get SLA Metric By ID`jiraservicemanagement_get_request_sla_metric`

Get a specific SLA metric by its ID for a customer request. Use list\_request\_sla\_information first to get the slaMetricI...

`read:request.sla:jira-service-management`

Get Request Status`jiraservicemanagement_get_request_status`

Get the status history of a customer request

`read:servicedesk-request`

List Request Transitions`jiraservicemanagement_list_request_transitions`

Get available workflow transitions for a request

`read:servicedesk-request`

Perform Request Transition`jiraservicemanagement_perform_request_transition`

Perform a workflow transition on a customer request

`write:request.status:jira-service-management`

## Events

Tags

Select all
|
Clear

Attachments

Comments

Issue Links

Requests

Users

Verification

Webhooks

Worklogs

No tags found

17 events

EventDescriptionTags

Webhook Ping`jiraservicemanagement_webhook_ping`

Acknowledges any delivery without a webhookEvent field (connectivity checks) with 200.

Verification

Request Created`jiraservicemanagement_webhook_issue_created`

Fires when a customer request (Jira issue) is created in a service project, from the portal, email channel, API, or by a...

RequestsWebhooks

Request Updated`jiraservicemanagement_webhook_issue_updated`

Fires when a customer request (Jira issue) changes, including status transitions, assignee changes, and field edits.

RequestsWebhooks

Request Deleted`jiraservicemanagement_webhook_issue_deleted`

Fires when a customer request (Jira issue) is deleted.

RequestsWebhooks

Comment Created`jiraservicemanagement_webhook_comment_created`

Fires when a comment is added to a request, whether a public reply to the customer or an internal note.

CommentsWebhooks

Comment Updated`jiraservicemanagement_webhook_comment_updated`

Fires when an existing comment on a request is edited.

CommentsWebhooks

Comment Deleted`jiraservicemanagement_webhook_comment_deleted`

Fires when a comment is deleted from a request.

CommentsWebhooks

Attachment Created`jiraservicemanagement_webhook_attachment_created`

Fires when a file is attached to a request.

AttachmentsWebhooks

Attachment Deleted`jiraservicemanagement_webhook_attachment_deleted`

Fires when an attachment is removed from a request.

AttachmentsWebhooks

Issue Link Created`jiraservicemanagement_webhook_issuelink_created`

Fires when a link is created between two issues, such as linking an incident to a problem or a request to a change.

Issue LinksWebhooks

Issue Link Deleted`jiraservicemanagement_webhook_issuelink_deleted`

Fires when a link between two issues is removed.

Issue LinksWebhooks

Worklog Created`jiraservicemanagement_webhook_worklog_created`

Fires when an agent logs time against a request.

WorklogsWebhooks

Worklog Updated`jiraservicemanagement_webhook_worklog_updated`

Fires when a time log on a request is edited.

WorklogsWebhooks

Worklog Deleted`jiraservicemanagement_webhook_worklog_deleted`

Fires when a time log is deleted from a request.

WorklogsWebhooks

User Created`jiraservicemanagement_webhook_user_created`

Fires when a user is created on the site, including agents and portal customers.

UsersWebhooks

User Updated`jiraservicemanagement_webhook_user_updated`

Fires when a user profile on the site is changed.

UsersWebhooks

User Deleted`jiraservicemanagement_webhook_user_deleted`

Fires when a user is removed from the site.

UsersWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.