---
title: "POST /api/v1/integrations/add-jiraservicedesk/"
method: POST
path: "/api/v1/integrations/add-jiraservicedesk/"
tags: ["integrations"]
---

# POST /api/v1/integrations/add-jiraservicedesk/

`POST /api/v1/integrations/add-jiraservicedesk/`

## Request

- Base URL: `https://uptime.com` (the document declares no server; this is the origin it was published from)
- URL: `https://uptime.com/api/v1/integrations/add-jiraservicedesk/`
- Auth: none declared
- TypeScript: <https://skmtc.dev/uptime/apis/uptime-com-openapi-schema/docs/api/v1/integrations/add-jiraservicedesk/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new Jira Service Desk integration

## Request body

- IntegrationJiraservicedesk
  - `pk` integer
  - `url` string
  - `name` string, required: Your preferred name for this integration.
  - `module` string: The provider of the integration.
  - `contact_groups` string[]: Array of contact names or IDs this integration is assigned to
  - `is_errored` boolean
  - `last_error` string
  - `api_email` string: Email of the user whose API token is being used.
  - `api_token` string: API Token created for the user, or the user's password (self-hosted only).
  - `jira_subdomain` string, uri: The domain your company uses to access Jira, e.g. "https://your-domain.atlassian.net"
  - `project_key` string: The project key of your Service Desk project, shown on the Project Settings > Details page. E.g. "SMPSRVDESK"
  - `labels` string: A comma separated list of labels attached to each incident created. The "Uptime.com" label any associated check tags are always set.
  - `custom_field_id_account_name` integer: An optional ID for a custom text field that should receive the account name.
  - `custom_field_id_check_name` integer: An optional ID for a custom text field that should receive the check name.
  - `custom_field_id_check_url` integer: An optional ID for a custom text field that should receive the check URL.
  - `custom_fields_json` string: <div class="dropdown"> Advanced configuration for custom fields using JSON format. See <a href="#" role="button" id="dropdownMenuLink" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">example values</a>. <div class="dropdown-menu border dark-shadow" style="width: 37rem;" aria-labelledby="dropdownMenuLink"> <pre><code> { "customfield_10000": "this is a text field", "customfield_20000": "this is a multi-line text field. big text.", "customfield_30000": "2011-07-13T15:25:00", "customfield_40000": { "value": "this is a select list value" }, "customfield_50000": { "name": "this is a group picker value" }, "customfield_60000": [ {"value": "this is a multi select list value #1"}, {"value": "this is a multi select list value #2"} ], } </code></pre> </div> </div>
  - `alert_resolved_label` string: When you fill in this field, a label will be added to the Jira issue once the Alert is resolved. Note: Spaces are not supported.

## Response `200`

- IntegrationJiraservicedesk
  - `pk` integer
  - `url` string
  - `name` string, required: Your preferred name for this integration.
  - `module` string: The provider of the integration.
  - `contact_groups` string[]: Array of contact names or IDs this integration is assigned to
  - `is_errored` boolean
  - `last_error` string
  - `api_email` string: Email of the user whose API token is being used.
  - `api_token` string: API Token created for the user, or the user's password (self-hosted only).
  - `jira_subdomain` string, uri: The domain your company uses to access Jira, e.g. "https://your-domain.atlassian.net"
  - `project_key` string: The project key of your Service Desk project, shown on the Project Settings > Details page. E.g. "SMPSRVDESK"
  - `labels` string: A comma separated list of labels attached to each incident created. The "Uptime.com" label any associated check tags are always set.
  - `custom_field_id_account_name` integer: An optional ID for a custom text field that should receive the account name.
  - `custom_field_id_check_name` integer: An optional ID for a custom text field that should receive the check name.
  - `custom_field_id_check_url` integer: An optional ID for a custom text field that should receive the check URL.
  - `custom_fields_json` string: <div class="dropdown"> Advanced configuration for custom fields using JSON format. See <a href="#" role="button" id="dropdownMenuLink" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">example values</a>. <div class="dropdown-menu border dark-shadow" style="width: 37rem;" aria-labelledby="dropdownMenuLink"> <pre><code> { "customfield_10000": "this is a text field", "customfield_20000": "this is a multi-line text field. big text.", "customfield_30000": "2011-07-13T15:25:00", "customfield_40000": { "value": "this is a select list value" }, "customfield_50000": { "name": "this is a group picker value" }, "customfield_60000": [ {"value": "this is a multi select list value #1"}, {"value": "this is a multi select list value #2"} ], } </code></pre> </div> </div>
  - `alert_resolved_label` string: When you fill in this field, a label will be added to the Jira issue once the Alert is resolved. Note: Spaces are not supported.

---

[API](https://skmtc.dev/uptime/apis/uptime-com-openapi-schema.md) - [All operations](https://skmtc.dev/uptime/apis/uptime-com-openapi-schema/llms.txt) - [OpenAPI document](https://skmtc.dev/uptime/apis/uptime-com-openapi-schema/revisions/e1e4a57a60d8?raw)