For AI agents and assistants: visit https://docs.pagerduty.com/llms.txt for the index.

Create a rule

Create a new rule.

A Rule configures the bidirectional synchronization between Jira issues and PagerDuty incidents.

Scoped OAuth requires: jira_cloud_rules.write

Authorization

Authorization<token>

In: header

Path Parameters

id*PagerDutyObfuscatedId

The ID of the account mapping.

Match^(P[0-9A-Z]{6}|Q[0-9A-Z]{13})$

FormatPagerDuty Id

Request Body

application/json

The rule to be created.

TypeScript Definitions

Use the request body type in TypeScript.

config*

Configuration for bidirectional synchronization between Jira issues and PagerDuty incidents.

enabled?|

Whether the rule is enabled.

name*string

The name of the rule.

Match^[^\x00-\x1F\x7F<>]+$

Lengthlength <= 100

Response Body

`application/json`

curl -X POST "https://api.pagerduty.com/integration-jira-cloud/accounts_mappings/PIJ90N7/rules" \  -H "Content-Type: application/json" \  -d '{    "config": {      "jira": {        "autocreate_jql": "priority = Highest",        "create_issue_on_incident_trigger": true,        "custom_fields": [          {            "source_incident_field": "incident_description",            "target_issue_field": "description",            "target_issue_field_name": "Description",            "type": "attribute"          },          {            "source_incident_field": "incident_number",            "target_issue_field": "customfield_10001",            "target_issue_field_name": "PagerDuty Incident Number",            "type": "attribute"          },          {            "target_issue_field": "security",            "target_issue_field_name": "Security Level",            "type": "jira_value",            "value": {              "displayName": "Sec Level 1",              "id": "10000"            }          },          {            "target_issue_field": "labels",            "target_issue_field_name": "Labels",            "type": "const",            "value": "pagerduty, incident"          }        ],        "issue_type": {          "id": "10001",          "name": "Incident"        },        "priorities": [          {            "jira_id": "1",            "pagerduty_id": "PUS0KTE"          },          {            "jira_id": "2",            "pagerduty_id": "PQFCJER"          },          {            "jira_id": "3",            "pagerduty_id": "PN6RJ21"          }        ],        "project": {          "id": "10100",          "key": "ITS",          "name": "IT Support"        },        "status_mapping": {          "acknowledged": {            "id": "2",            "name": "In Progress"          },          "resolved": {            "id": "3",            "name": "Resolved"          },          "triggered": {            "id": "1",            "name": "Open"          }        },        "sync_notes_user": {          "id": "PBAZLIU",          "type": "user_reference"        }      },      "service": {        "id": "PY1OL64",        "type": "service_reference"      }    },    "name": "Critical IT Incidents",    "enabled": true  }'

{  "account_mapping": {    "id": "PIJ90N7",    "self": "https://api.pagerduty.com/integration-jira-cloud/account_mappings/PIJ90N7",    "type": "accounts_mapping_reference"  },  "config": {    "jira": {      "autocreate_jql": "priority = Highest",      "create_issue_on_incident_trigger": true,      "custom_fields": [        {          "source_incident_field": "incident_description",          "target_issue_field": "description",          "target_issue_field_name": "Description",          "type": "attribute"        },        {          "source_incident_field": "incident_number",          "target_issue_field": "customfield_10001",          "target_issue_field_name": "PagerDuty Incident Number",          "type": "attribute"        },        {          "target_issue_field": "security",          "target_issue_field_name": "Security Level",          "type": "jira_value",          "value": {            "displayName": "Sec Level 1",            "id": "10000"          }        },        {          "target_issue_field": "labels",          "target_issue_field_name": "Labels",          "type": "const",          "value": "pagerduty, incident"        }      ],      "issue_type": {        "id": "10001",        "name": "Incident"      },      "priorities": [        {          "jira_id": "1",          "pagerduty_id": "PUS0KTE"        },        {          "jira_id": "2",          "pagerduty_id": "PQFCJER"        },        {          "jira_id": "3",          "pagerduty_id": "PN6RJ21"        }      ],      "project": {        "id": "10100",        "key": "ITS",        "name": "IT Support"      },      "status_mapping": {        "acknowledged": {          "id": "2",          "name": "In Progress"        },        "resolved": {          "id": "3",          "name": "Resolved"        },        "triggered": {          "id": "1",          "name": "Open"        }      },      "sync_notes_user": {        "email": "e.greenholt@example.com",        "html_url": "https://subdomain.pagerduty.com/users/PBAZLIU",        "id": "PBAZLIU",        "name": "Earline Greenholt",        "self": "https://api.pagerduty.com/users/PBAZLIU",        "type": "user_reference"      },      "version": 1    },    "service": {      "html_url": "https://api.pagerduty.com/services/PY1OL64",      "id": "PY1OL64",      "self": "https://api.pagerduty.com/services/PY1OL64",      "summary": "Main Web Application",      "type": "service_reference"    }  },  "created_at": "2023-09-01T12:00:00.000Z",  "id": "PF9KMXH",  "name": "Critical IT Incidents",  "enabled": true,  "updated_at": "2023-09-01T12:00:00.000Z"}

Create a rule

Authorization

Path Parameters

Request Body

Response Body

201application/json

400application/json

401

403application/json

429application/json

500application/json

Developer Agreement

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`