Settings API - Problem notifications schema table

Problem notifications (`builtin:problem.notifications)`

Although the Dynatrace mobile app is the preferred method for receiving real-time notifications related to problems in your environment, if your organization uses email or a different ticket/incident management system for alerting, click Add notification to configure integration with Dynatrace.

Integrate Dynatrace problem notifications with your organization's existing incident-management system or team-collaboration channel. Alerting profiles are used within problem integrations to filter the total number of alerts to a subset that is relevant for your team.

For details see Third-party integrations.

Schema ID	Schema groups	Scope
`builtin:problem.notifications`	`group:integration`	`environment`

GET	Managed	`https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:problem.notifications`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:problem.notifications`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:problem.notifications`

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Property	Type	Description	Required
Enabled `enabled`	boolean	-	required
Notification type `type`	enum	`EMAIL` `SLACK` `JIRA` `ANSIBLETOWER` `OPS_GENIE` `PAGER_DUTY` `VICTOROPS` `WEBHOOK` `XMATTERS` `TRELLO` `SERVICE_NOW`	required
Display name `displayName`	text	The name of the notification configuration.	required
`emailNotification`	EmailNotification	-	required
`slackNotification`	SlackNotification	-	required
`jiraNotification`	JiraNotification	-	required
`ansibleTowerNotification`	AnsibleTowerNotification	-	required
`opsGenieNotification`	OpsGenieNotification	-	required
`pagerDutyNotification`	PagerDutyNotification	-	required
`victorOpsNotification`	VictorOpsNotification	-	required
`webHookNotification`	WebHookNotification	-	required
`xMattersNotification`	XMattersNotification	-	required
`trelloNotification`	TrelloNotification	-	required
`serviceNowNotification`	ServiceNowNotification	-	required
Alerting profile `alertingProfile`	setting	Select an alerting profile (`<your-dynatrace-url>//ui/settings/builtin:alerting.profile`) to control the delivery of problem notifications related to this integration.	required

The `EmailNotification` object

Property	Type	Description	Required
To `recipients`	set	-	required
CC `ccRecipients`	set	-	required
BCC `bccRecipients`	set	-	required
Subject `subject`	text	The subject of the email notifications. Type '{' for placeholder suggestions. {ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities). {ImpactedEntityNames}: The entity impacted by the problem. {NamesOfImpactedEntities}: The names of all entities that are impacted by the problem. {PID}: Unique system identifier of the reported problem. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {ProblemURL}: URL of the problem within Dynatrace. {State}: Problem state. Possible values are OPEN or RESOLVED. {Tags}: Comma separated list of tags that are defined for all impacted entities. To refer to the value of a specific tag, specify the tag's key in square brackets: {Tags[key]}. If the tag does not have any assigned value, the placeholder will be replaced by an empty string. The placeholder will not be replaced if the tag key does not exist.	required
Send email if problem is closed `notifyClosedProblems`	boolean	-	required
Body `body`	text	The template of the email notifications. Type '{' for placeholder suggestions. {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array. {ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities). {ImpactedEntityNames}: The entity impacted by the problem. {NamesOfImpactedEntities}: The names of all entities that are impacted by the problem. {PID}: Unique system identifier of the reported problem. {ProblemDetailsHTML}: All problem event details including root cause as an HTML-formatted string. {ProblemDetailsJSONv2}: Problem as json object following the structure from the Dynatrace Problems V2 API. The optional fields evidenceDetails and impactAnalysis are included, but recentComments is not. {ProblemDetailsJSON}: Problem as json object following the structure from the Dynatrace Problems V1 API. {ProblemDetailsMarkdown}: All problem event details including root cause as a Markdown-formatted string. {ProblemDetailsText}: All problem event details including root cause as a text-formatted string. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {ProblemURL}: URL of the problem within Dynatrace. {State}: Problem state. Possible values are OPEN or RESOLVED. {Tags}: Comma separated list of tags that are defined for all impacted entities. To refer to the value of a specific tag, specify the tag's key in square brackets: {Tags[key]}. If the tag does not have any assigned value, the placeholder will be replaced by an empty string. The placeholder will not be replaced if the tag key does not exist.	required

The `SlackNotification` object

Property Type Description Required

Property	Type	Description	Required
URL `url`	secret	Set up an incoming WebHook integration within your Slack account. Copy and paste the generated WebHook URL into the field above.	required
Channel `channel`	text	The channel (for example, `#general`) or the user (for example, `@john.smith`) to send the message to.	required
Message `message`	text	The content of the message. Type '{' for placeholder suggestions. {ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities). {ImpactedEntityNames}: The entity impacted by the problem. {NamesOfImpactedEntities}: The names of all entities that are impacted by the problem. {PID}: Unique system identifier of the reported problem. {ProblemDetailsText}: All problem event details including root cause as a text-formatted string. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {ProblemURL}: URL of the problem within Dynatrace. {State}: Problem state. Possible values are OPEN or RESOLVED. {Tags}: Comma separated list of tags that are defined for all impacted entities. To refer to the value of a specific tag, specify the tag's key in square brackets: {Tags[key]}. If the tag does not have any assigned value, the placeholder will be replaced by an empty string. The placeholder will not be replaced if the tag key does not exist.	required

URL
url

secret

Set up an incoming WebHook integration within your Slack account. Copy and paste the generated WebHook URL into the field above.

required

Channel
channel

text

The channel (for example, #general) or the user (for example, @john.smith) to send the message to.

required

Message
message

text

The content of the message. Type '{' for placeholder suggestions.

{ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities).

{ImpactedEntityNames}: The entity impacted by the problem.

{NamesOfImpactedEntities}: The names of all entities that are impacted by the problem.

{PID}: Unique system identifier of the reported problem.

{ProblemDetailsText}: All problem event details including root cause as a text-formatted string.

{ProblemID}: Display number of the reported problem.

{ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE.

{ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT.

{ProblemTitle}: Short description of the problem.

{ProblemURL}: URL of the problem within Dynatrace.

{State}: Problem state. Possible values are OPEN or RESOLVED.

{Tags}: Comma separated list of tags that are defined for all impacted entities. To refer to the value of a specific tag, specify the tag's key in square brackets: {Tags[key]}. If the tag does not have any assigned value, the placeholder will be replaced by an empty string. The placeholder will not be replaced if the tag key does not exist.

required

The `JiraNotification` object

Property	Type	Description	Required
Jira endpoint URL `url`	text	The URL of the Jira API endpoint.	required
Username `username`	text	The username of the Jira profile.	required
API token `apiToken`	secret	The API token for the Jira profile. Using password authentication was deprecated by Jira	required
Project key `projectKey`	text	The project key of the Jira issue to be created by this notification.	required
Issue type `issueType`	text	The type of the Jira issue to be created by this notification. To find all available issue types, or to create your own issue type, within JIRA go to Options > Issues.	required
Summary `summary`	text	The summary of the Jira issue to be created by this notification. Type '{' for placeholder suggestions. {ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities). {ImpactedEntityNames}: The entity impacted by the problem. {NamesOfImpactedEntities}: The names of all entities that are impacted by the problem. {PID}: Unique system identifier of the reported problem. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {ProblemURL}: URL of the problem within Dynatrace. {State}: Problem state. Possible values are OPEN or RESOLVED. {Tags}: Comma separated list of tags that are defined for all impacted entities. To refer to the value of a specific tag, specify the tag's key in square brackets: {Tags[key]}. If the tag does not have any assigned value, the placeholder will be replaced by an empty string. The placeholder will not be replaced if the tag key does not exist.	required
Issue description `description`	text	The description of the Jira issue to be created by this notification. Type '{' for placeholder suggestions. {ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities). {ImpactedEntityNames}: The entity impacted by the problem. {NamesOfImpactedEntities}: The names of all entities that are impacted by the problem. {PID}: Unique system identifier of the reported problem. {ProblemDetailsText}: All problem event details including root cause as a text-formatted string. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {ProblemURL}: URL of the problem within Dynatrace. {State}: Problem state. Possible values are OPEN or RESOLVED. {Tags}: Comma separated list of tags that are defined for all impacted entities. To refer to the value of a specific tag, specify the tag's key in square brackets: {Tags[key]}. If the tag does not have any assigned value, the placeholder will be replaced by an empty string. The placeholder will not be replaced if the tag key does not exist.	required

The `AnsibleTowerNotification` object

Property	Type	Description	Required
Job template URL `jobTemplateURL`	text	The URL of the target job template. For example, https:///#/templates/job_template/ Note: Be sure to select the Prompt on Launch option in the Extra Variables section of your job template configuration.	required
Accept any SSL certificate (including self-signed and invalid certificates) `acceptAnyCertificate`	boolean	-	required
Username `username`	text	Account username.	required
Password `password`	secret	Account password.	required
Custom message (optional) `customMessage`	text	This message will be displayed in the Extra Variables Message field of your job template. Type '{' for placeholder suggestions. {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array. {ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities). {ImpactedEntityNames}: The entity impacted by the problem. {NamesOfImpactedEntities}: The names of all entities that are impacted by the problem. {PID}: Unique system identifier of the reported problem. {ProblemDetailsText}: All problem event details including root cause as a text-formatted string. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {ProblemURL}: URL of the problem within Dynatrace. {State}: Problem state. Possible values are OPEN or RESOLVED. {Tags}: Comma separated list of tags that are defined for all impacted entities. To refer to the value of a specific tag, specify the tag's key in square brackets: {Tags[key]}. If the tag does not have any assigned value, the placeholder will be replaced by an empty string. The placeholder will not be replaced if the tag key does not exist.	required

The `OpsGenieNotification` object

Property Type Description Required

Property	Type	Description	Required
OpsGenie API key `apiKey`	secret	The API key to access OpsGenie. Go to OpsGenie-Integrations and create a new Dynatrace integration. Copy the newly created API key.	required
OpsGenie region domain `domain`	text	The region domain of the OpsGenie. For example, api.opsgenie.com for US or api.eu.opsgenie.com for EU.	required
Message `message`	text	The content of the message. Type '{' for placeholder suggestions. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {ImpactedEntityNames}: The entity impacted by the problem (or multiple impacted entities).	required

OpsGenie API key
apiKey

secret

The API key to access OpsGenie.

Go to OpsGenie-Integrations and create a new Dynatrace integration. Copy the newly created API key.

required

OpsGenie region domain
domain

text

The region domain of the OpsGenie.

For example, api.opsgenie.com for US or api.eu.opsgenie.com for EU.

required

Message
message

text

The content of the message. Type '{' for placeholder suggestions.

{ProblemID}: Display number of the reported problem.

{ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE.

{ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT.

{ProblemTitle}: Short description of the problem.

{ImpactedEntityNames}: The entity impacted by the problem (or multiple impacted entities).

required

The `PagerDutyNotification` object

Property	Type	Description	Required
Account `account`	text	The name of the PagerDuty account.	required
Service name `serviceName`	text	The name of the service.	required
Service key `serviceApiKey`	secret	The Events API key to access PagerDuty.	required

The `VictorOpsNotification` object

Property Type Description Required

Property	Type	Description	Required
API key `apiKey`	secret	The API key for the target VictorOps account. Receive your VictorOps API key by navigating to: Settings -> Integrations -> Rest Endpoint -> Dynatrace within your VictorOps account.	required
Routing key `routingKey`	text	The routing key, defining the group to be notified.	required
Message `message`	text	The content of the message. Type '{' for placeholder suggestions. {ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities). {ImpactedEntityNames}: The entity impacted by the problem. {NamesOfImpactedEntities}: The names of all entities that are impacted by the problem. {ProblemDetailsText}: All problem event details including root cause as a text-formatted string. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {ProblemURL}: URL of the problem within Dynatrace. {State}: Problem state. Possible values are OPEN or RESOLVED.	required

API key
apiKey

secret

The API key for the target VictorOps account.

Receive your VictorOps API key by navigating to: Settings -> Integrations -> Rest Endpoint -> Dynatrace within your VictorOps account.

required

Routing key
routingKey

text

The routing key, defining the group to be notified.

required

Message
message

text

The content of the message. Type '{' for placeholder suggestions.

{ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities).

{ImpactedEntityNames}: The entity impacted by the problem.

{NamesOfImpactedEntities}: The names of all entities that are impacted by the problem.

{ProblemDetailsText}: All problem event details including root cause as a text-formatted string.

{ProblemID}: Display number of the reported problem.

{ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE.

{ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT.

{ProblemTitle}: Short description of the problem.

{ProblemURL}: URL of the problem within Dynatrace.

{State}: Problem state. Possible values are OPEN or RESOLVED.

required

The `WebHookNotification` object

Property	Type	Description	Required
Secret webhook URL `urlContainsSecret`	boolean	-	optional
Webhook URL `url`	text	The URL of the webhook endpoint.	required
Webhook URL `secretUrl`	secret	The secret URL of the webhook endpoint.	required
Accept any SSL certificate (including self-signed and invalid certificates) `acceptAnyCertificate`	boolean	-	required
Call webhook if new events merge into existing problems `notifyEventMergesEnabled`	boolean	-	required
Call webhook if problem is closed `notifyClosedProblems`	boolean	-	required
Use OAuth 2.0 for authentication `useOAuth2`	boolean	-	optional
OAuth 2.0 credentials `oAuth2Credentials`	OAuth2Credentials	To authenticate your integration, the OAuth 2.0 Client Credentials Flow (Grant Type) is used. For details see Client Credentials Flow). The obtained Access Token is subsequently provided in the Authorization header of the request carrying the notification payload.	required
Additional HTTP headers `headers`	Set<WebHookNotificationHeader>	A list of the additional HTTP headers.	required
Custom payload `payload`	text	The content of the notification message. Type '{' for placeholder suggestions. {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array. {ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities). {ImpactedEntityNames}: The entity impacted by the problem. {NamesOfImpactedEntities}: The names of all entities that are impacted by the problem. {PID}: Unique system identifier of the reported problem. {ProblemDetailsHTML}: All problem event details including root cause as an HTML-formatted string. {ProblemDetailsJSONv2}: Problem as json object following the structure from the Dynatrace Problems V2 API. The optional fields evidenceDetails and impactAnalysis are included, but recentComments is not. {ProblemDetailsJSON}: Problem as json object following the structure from the Dynatrace Problems V1 API. {ProblemDetailsMarkdown}: All problem event details including root cause as a Markdown-formatted string. {ProblemDetailsText}: All problem event details including root cause as a text-formatted string. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {ProblemURL}: URL of the problem within Dynatrace. {State}: Problem state. Possible values are OPEN or RESOLVED. {Tags}: Comma separated list of tags that are defined for all impacted entities. To refer to the value of a specific tag, specify the tag's key in square brackets: {Tags[key]}. If the tag does not have any assigned value, the placeholder will be replaced by an empty string. The placeholder will not be replaced if the tag key does not exist.	required

The `XMattersNotification` object

Property	Type	Description	Required
xMatters URL `url`	text	The URL of the xMatters webhook.	required
Accept any SSL certificate (including self-signed and invalid certificates) `acceptAnyCertificate`	boolean	-	required
Additional HTTP headers `headers`	Set<WebHookNotificationHeader>	A list of the additional HTTP headers.	required
Custom payload `payload`	text	The content of the notification message. Type '{' for placeholder suggestions. {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array. {ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities). {ImpactedEntityNames}: The entity impacted by the problem. {NamesOfImpactedEntities}: The names of all entities that are impacted by the problem. {PID}: Unique system identifier of the reported problem. {ProblemDetailsHTML}: All problem event details including root cause as an HTML-formatted string. {ProblemDetailsJSONv2}: Problem as json object following the structure from the Dynatrace Problems V2 API. The optional fields evidenceDetails and impactAnalysis are included, but recentComments is not. {ProblemDetailsJSON}: Problem as json object following the structure from the Dynatrace Problems V1 API. {ProblemDetailsMarkdown}: All problem event details including root cause as a Markdown-formatted string. {ProblemDetailsText}: All problem event details including root cause as a text-formatted string. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {ProblemURL}: URL of the problem within Dynatrace. {State}: Problem state. Possible values are OPEN or RESOLVED. {Tags}: Comma separated list of tags that are defined for all impacted entities. To refer to the value of a specific tag, specify the tag's key in square brackets: {Tags[key]}. If the tag does not have any assigned value, the placeholder will be replaced by an empty string. The placeholder will not be replaced if the tag key does not exist.	required

The `TrelloNotification` object

Property	Type	Description	Required
Trello application key `applicationKey`	text	The application key for the Trello account. You must be logged into Trello to have Trello automatically generate an application key for you. Get application key	required
Trello authorization token `authorizationToken`	secret	The authorization token for the Trello account.	required
Trello board ID problem cards should be assigned to `boardId`	text	-	required
Trello list ID new problem cards should be assigned to `listId`	text	-	required
Trello list ID resolved problem cards should be assigned to `resolvedListId`	text	-	required
Card text `text`	text	The card text and problem placeholders to appear on new problem cards. Type '{' for placeholder suggestions. {ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities). {ImpactedEntityNames}: The entity impacted by the problem. {NamesOfImpactedEntities}: The names of all entities that are impacted by the problem. {PID}: Unique system identifier of the reported problem. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {ProblemURL}: URL of the problem within Dynatrace. {State}: Problem state. Possible values are OPEN or RESOLVED. {Tags}: Comma separated list of tags that are defined for all impacted entities. To refer to the value of a specific tag, specify the tag's key in square brackets: {Tags[key]}. If the tag does not have any assigned value, the placeholder will be replaced by an empty string. The placeholder will not be replaced if the tag key does not exist.	required
Card description `description`	text	The description of the Trello card. Type '{' for placeholder suggestions. {ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities). {ImpactedEntityNames}: The entity impacted by the problem. {NamesOfImpactedEntities}: The names of all entities that are impacted by the problem. {PID}: Unique system identifier of the reported problem. {ProblemDetailsMarkdown}: All problem event details including root cause as a Markdown-formatted string. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {ProblemURL}: URL of the problem within Dynatrace. {State}: Problem state. Possible values are OPEN or RESOLVED. {Tags}: Comma separated list of tags that are defined for all impacted entities. To refer to the value of a specific tag, specify the tag's key in square brackets: {Tags[key]}. If the tag does not have any assigned value, the placeholder will be replaced by an empty string. The placeholder will not be replaced if the tag key does not exist.	required

The `ServiceNowNotification` object

Property	Type	Description	Required
ServiceNow instance identifier `instanceName`	text	The ServiceNow instance identifier. It refers to the first part of your own ServiceNow URL. This field is mutually exclusive with the url field. You can only use one of them.	required
OnPremise URL `url`	text	The URL of the on-premise ServiceNow installation. This field is mutually exclusive with the instanceName field. You can only use one of them.	optional
Username `username`	text	The username of the ServiceNow account. Make sure that your user account has the `web_service_admin` and `x_dynat_ruxit.Integration` roles.	required
Password `password`	secret	The password to the ServiceNow account.	required
Description `message`	text	The content of the ServiceNow description. Type '{' for placeholder suggestions. {ImpactedEntity}: A short description of the problem and impacted entity (or multiple impacted entities). {ImpactedEntityNames}: The entity impacted by the problem. {NamesOfImpactedEntities}: The names of all entities that are impacted by the problem. {PID}: Unique system identifier of the reported problem. {ProblemDetailsHTML}: All problem event details including root cause as an HTML-formatted string. {ProblemDetailsText}: All problem event details including root cause as a text-formatted string. {ProblemID}: Display number of the reported problem. {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE. {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT. {ProblemTitle}: Short description of the problem. {State}: Problem state. Possible values are OPEN or RESOLVED. {Tags}: Comma separated list of tags that are defined for all impacted entities. To refer to the value of a specific tag, specify the tag's key in square brackets: {Tags[key]}. If the tag does not have any assigned value, the placeholder will be replaced by an empty string. The placeholder will not be replaced if the tag key does not exist.	required
Send incidents into ServiceNow ITSM. `sendIncidents`	boolean	-	required
Send events into ServiceNow ITOM. `sendEvents`	boolean	-	required
Use text format for problem details instead of HTML. `formatProblemDetailsAsText`	boolean	-	optional

The `OAuth2Credentials` object

Property	Type	Description	Required
Access token URL `accessTokenUrl`	text	-	required
Client ID `clientId`	text	-	required
Client secret `clientSecret`	secret	-	required
Scope `scope`	text	The scope of access you are requesting	optional
Include the client credentials in the HTTP "Authorization" request header field with the HTTP "Basic" authentication scheme. `authenticateViaRequestHeader`	boolean	If false, the client credentials are included in the HTTP request body.	optional

The `WebHookNotificationHeader` object

Property	Type	Description	Required
Name `name`	text	The name of the HTTP header.	required
Secret HTTP header value `secret`	boolean	-	required
Value `value`	text	The value of the HTTP header. May contain an empty value.	required
Value `secretValue`	secret	The secret value of the HTTP header. May contain an empty value.	required

Settings API - Problem notifications schema table

Problem notifications (builtin:problem.notifications)

Authentication

Parameters

The EmailNotification object

The SlackNotification object

The JiraNotification object

The AnsibleTowerNotification object

The OpsGenieNotification object

The PagerDutyNotification object

The VictorOpsNotification object

The WebHookNotification object

The XMattersNotification object

The TrelloNotification object

The ServiceNowNotification object

The OAuth2Credentials object

The WebHookNotificationHeader object

Problem notifications (`builtin:problem.notifications)`

The `EmailNotification` object

The `SlackNotification` object

The `JiraNotification` object

The `AnsibleTowerNotification` object

The `OpsGenieNotification` object

The `PagerDutyNotification` object

The `VictorOpsNotification` object

The `WebHookNotification` object

The `XMattersNotification` object

The `TrelloNotification` object

The `ServiceNowNotification` object

The `OAuth2Credentials` object

The `WebHookNotificationHeader` object