published on Tuesday, Jun 9, 2026 by Pulumiverse
published on Tuesday, Jun 9, 2026 by Pulumiverse
This resource requires the API token scopes Read settings (
settings.read) and Write settings (settings.write)
Dynatrace Documentation
xMatters integration - https://www.dynatrace.com/support/help/setup-and-configuration/integrations/problem-notifications/xmatters-integration
Settings API - https://www.dynatrace.com/support/help/dynatrace-api/environment-api/settings (schemaId:
builtin:problem.notifications)
Export Example Usage
terraform-provider-dynatrace -export dynatrace.XmattersNotificationdownloads the existing problem notifications for xMatters
The full documentation of the export feature is available here.
Create XmattersNotification Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new XmattersNotification(name: string, args: XmattersNotificationArgs, opts?: CustomResourceOptions);@overload
def XmattersNotification(resource_name: str,
args: XmattersNotificationArgs,
opts: Optional[ResourceOptions] = None)
@overload
def XmattersNotification(resource_name: str,
opts: Optional[ResourceOptions] = None,
active: Optional[bool] = None,
payload: Optional[str] = None,
profile: Optional[str] = None,
url: Optional[str] = None,
headers: Optional[XmattersNotificationHeadersArgs] = None,
insecure: Optional[bool] = None,
legacy_id: Optional[str] = None,
name: Optional[str] = None)func NewXmattersNotification(ctx *Context, name string, args XmattersNotificationArgs, opts ...ResourceOption) (*XmattersNotification, error)public XmattersNotification(string name, XmattersNotificationArgs args, CustomResourceOptions? opts = null)
public XmattersNotification(String name, XmattersNotificationArgs args)
public XmattersNotification(String name, XmattersNotificationArgs args, CustomResourceOptions options)
type: dynatrace:XmattersNotification
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "dynatrace_xmattersnotification" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args XmattersNotificationArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args XmattersNotificationArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args XmattersNotificationArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args XmattersNotificationArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args XmattersNotificationArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var xmattersNotificationResource = new Dynatrace.XmattersNotification("xmattersNotificationResource", new()
{
Active = false,
Payload = "string",
Profile = "string",
Url = "string",
Headers = new Dynatrace.Inputs.XmattersNotificationHeadersArgs
{
Headers = new[]
{
new Dynatrace.Inputs.XmattersNotificationHeadersHeaderArgs
{
Name = "string",
SecretValue = "string",
Value = "string",
},
},
},
Insecure = false,
LegacyId = "string",
Name = "string",
});
example, err := dynatrace.NewXmattersNotification(ctx, "xmattersNotificationResource", &dynatrace.XmattersNotificationArgs{
Active: pulumi.Bool(false),
Payload: pulumi.String("string"),
Profile: pulumi.String("string"),
Url: pulumi.String("string"),
Headers: &dynatrace.XmattersNotificationHeadersArgs{
Headers: dynatrace.XmattersNotificationHeadersHeaderArray{
&dynatrace.XmattersNotificationHeadersHeaderArgs{
Name: pulumi.String("string"),
SecretValue: pulumi.String("string"),
Value: pulumi.String("string"),
},
},
},
Insecure: pulumi.Bool(false),
LegacyId: pulumi.String("string"),
Name: pulumi.String("string"),
})
resource "dynatrace_xmattersnotification" "xmattersNotificationResource" {
active = false
payload = "string"
profile = "string"
url = "string"
headers = {
headers = [{
"name" = "string"
"secretValue" = "string"
"value" = "string"
}]
}
insecure = false
legacy_id = "string"
name = "string"
}
var xmattersNotificationResource = new XmattersNotification("xmattersNotificationResource", XmattersNotificationArgs.builder()
.active(false)
.payload("string")
.profile("string")
.url("string")
.headers(XmattersNotificationHeadersArgs.builder()
.headers(XmattersNotificationHeadersHeaderArgs.builder()
.name("string")
.secretValue("string")
.value("string")
.build())
.build())
.insecure(false)
.legacyId("string")
.name("string")
.build());
xmatters_notification_resource = dynatrace.XmattersNotification("xmattersNotificationResource",
active=False,
payload="string",
profile="string",
url="string",
headers={
"headers": [{
"name": "string",
"secret_value": "string",
"value": "string",
}],
},
insecure=False,
legacy_id="string",
name="string")
const xmattersNotificationResource = new dynatrace.XmattersNotification("xmattersNotificationResource", {
active: false,
payload: "string",
profile: "string",
url: "string",
headers: {
headers: [{
name: "string",
secretValue: "string",
value: "string",
}],
},
insecure: false,
legacyId: "string",
name: "string",
});
type: dynatrace:XmattersNotification
properties:
active: false
headers:
headers:
- name: string
secretValue: string
value: string
insecure: false
legacyId: string
name: string
payload: string
profile: string
url: string
XmattersNotification Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The XmattersNotification resource accepts the following input properties:
- Active bool
- This setting is enabled (
true) or disabled (false) - Payload string
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- Profile string
- The ID of the associated alerting profile
- Url string
- The URL of the xMatters webhook.
- Headers
Pulumiverse.
Dynatrace. Inputs. Xmatters Notification Headers - A list of the additional HTTP headers.
- Insecure bool
- Accept any SSL certificate (including self-signed and invalid certificates)
- Legacy
Id string - The ID of these settings when referred to from resources requiring the REST API V1 keys
- Name string
- The name of the notification configuration.
- Active bool
- This setting is enabled (
true) or disabled (false) - Payload string
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- Profile string
- The ID of the associated alerting profile
- Url string
- The URL of the xMatters webhook.
- Headers
Xmatters
Notification Headers Args - A list of the additional HTTP headers.
- Insecure bool
- Accept any SSL certificate (including self-signed and invalid certificates)
- Legacy
Id string - The ID of these settings when referred to from resources requiring the REST API V1 keys
- Name string
- The name of the notification configuration.
- active bool
- This setting is enabled (
true) or disabled (false) - payload string
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- profile string
- The ID of the associated alerting profile
- url string
- The URL of the xMatters webhook.
- headers object
- A list of the additional HTTP headers.
- insecure bool
- Accept any SSL certificate (including self-signed and invalid certificates)
- legacy_
id string - The ID of these settings when referred to from resources requiring the REST API V1 keys
- name string
- The name of the notification configuration.
- active Boolean
- This setting is enabled (
true) or disabled (false) - payload String
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- profile String
- The ID of the associated alerting profile
- url String
- The URL of the xMatters webhook.
- headers
Xmatters
Notification Headers - A list of the additional HTTP headers.
- insecure Boolean
- Accept any SSL certificate (including self-signed and invalid certificates)
- legacy
Id String - The ID of these settings when referred to from resources requiring the REST API V1 keys
- name String
- The name of the notification configuration.
- active boolean
- This setting is enabled (
true) or disabled (false) - payload string
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- profile string
- The ID of the associated alerting profile
- url string
- The URL of the xMatters webhook.
- headers
Xmatters
Notification Headers - A list of the additional HTTP headers.
- insecure boolean
- Accept any SSL certificate (including self-signed and invalid certificates)
- legacy
Id string - The ID of these settings when referred to from resources requiring the REST API V1 keys
- name string
- The name of the notification configuration.
- active bool
- This setting is enabled (
true) or disabled (false) - payload str
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- profile str
- The ID of the associated alerting profile
- url str
- The URL of the xMatters webhook.
- headers
Xmatters
Notification Headers Args - A list of the additional HTTP headers.
- insecure bool
- Accept any SSL certificate (including self-signed and invalid certificates)
- legacy_
id str - The ID of these settings when referred to from resources requiring the REST API V1 keys
- name str
- The name of the notification configuration.
- active Boolean
- This setting is enabled (
true) or disabled (false) - payload String
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- profile String
- The ID of the associated alerting profile
- url String
- The URL of the xMatters webhook.
- headers Property Map
- A list of the additional HTTP headers.
- insecure Boolean
- Accept any SSL certificate (including self-signed and invalid certificates)
- legacy
Id String - The ID of these settings when referred to from resources requiring the REST API V1 keys
- name String
- The name of the notification configuration.
Outputs
All input properties are implicitly available as output properties. Additionally, the XmattersNotification resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id str
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
Look up Existing XmattersNotification Resource
Get an existing XmattersNotification resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: XmattersNotificationState, opts?: CustomResourceOptions): XmattersNotification@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
active: Optional[bool] = None,
headers: Optional[XmattersNotificationHeadersArgs] = None,
insecure: Optional[bool] = None,
legacy_id: Optional[str] = None,
name: Optional[str] = None,
payload: Optional[str] = None,
profile: Optional[str] = None,
url: Optional[str] = None) -> XmattersNotificationfunc GetXmattersNotification(ctx *Context, name string, id IDInput, state *XmattersNotificationState, opts ...ResourceOption) (*XmattersNotification, error)public static XmattersNotification Get(string name, Input<string> id, XmattersNotificationState? state, CustomResourceOptions? opts = null)public static XmattersNotification get(String name, Output<String> id, XmattersNotificationState state, CustomResourceOptions options)resources: _: type: dynatrace:XmattersNotification get: id: ${id}import {
to = dynatrace_xmattersnotification.example
id = "${id}"
}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Active bool
- This setting is enabled (
true) or disabled (false) - Headers
Pulumiverse.
Dynatrace. Inputs. Xmatters Notification Headers - A list of the additional HTTP headers.
- Insecure bool
- Accept any SSL certificate (including self-signed and invalid certificates)
- Legacy
Id string - The ID of these settings when referred to from resources requiring the REST API V1 keys
- Name string
- The name of the notification configuration.
- Payload string
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- Profile string
- The ID of the associated alerting profile
- Url string
- The URL of the xMatters webhook.
- Active bool
- This setting is enabled (
true) or disabled (false) - Headers
Xmatters
Notification Headers Args - A list of the additional HTTP headers.
- Insecure bool
- Accept any SSL certificate (including self-signed and invalid certificates)
- Legacy
Id string - The ID of these settings when referred to from resources requiring the REST API V1 keys
- Name string
- The name of the notification configuration.
- Payload string
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- Profile string
- The ID of the associated alerting profile
- Url string
- The URL of the xMatters webhook.
- active bool
- This setting is enabled (
true) or disabled (false) - headers object
- A list of the additional HTTP headers.
- insecure bool
- Accept any SSL certificate (including self-signed and invalid certificates)
- legacy_
id string - The ID of these settings when referred to from resources requiring the REST API V1 keys
- name string
- The name of the notification configuration.
- payload string
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- profile string
- The ID of the associated alerting profile
- url string
- The URL of the xMatters webhook.
- active Boolean
- This setting is enabled (
true) or disabled (false) - headers
Xmatters
Notification Headers - A list of the additional HTTP headers.
- insecure Boolean
- Accept any SSL certificate (including self-signed and invalid certificates)
- legacy
Id String - The ID of these settings when referred to from resources requiring the REST API V1 keys
- name String
- The name of the notification configuration.
- payload String
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- profile String
- The ID of the associated alerting profile
- url String
- The URL of the xMatters webhook.
- active boolean
- This setting is enabled (
true) or disabled (false) - headers
Xmatters
Notification Headers - A list of the additional HTTP headers.
- insecure boolean
- Accept any SSL certificate (including self-signed and invalid certificates)
- legacy
Id string - The ID of these settings when referred to from resources requiring the REST API V1 keys
- name string
- The name of the notification configuration.
- payload string
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- profile string
- The ID of the associated alerting profile
- url string
- The URL of the xMatters webhook.
- active bool
- This setting is enabled (
true) or disabled (false) - headers
Xmatters
Notification Headers Args - A list of the additional HTTP headers.
- insecure bool
- Accept any SSL certificate (including self-signed and invalid certificates)
- legacy_
id str - The ID of these settings when referred to from resources requiring the REST API V1 keys
- name str
- The name of the notification configuration.
- payload str
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- profile str
- The ID of the associated alerting profile
- url str
- The URL of the xMatters webhook.
- active Boolean
- This setting is enabled (
true) or disabled (false) - headers Property Map
- A list of the additional HTTP headers.
- insecure Boolean
- Accept any SSL certificate (including self-signed and invalid certificates)
- legacy
Id String - The ID of these settings when referred to from resources requiring the REST API V1 keys
- name String
- The name of the notification configuration.
- payload String
- The content of the notification message. Type '{' for placeholder suggestions.. #### Available placeholders {ImpactedEntities}: Details about the entities impacted by the problem in form of a json array.
- profile String
- The ID of the associated alerting profile
- url String
- The URL of the xMatters webhook.
Supporting Types
XmattersNotificationHeaders, XmattersNotificationHeadersArgs
- Headers
List<Pulumiverse.
Dynatrace. Inputs. Xmatters Notification Headers Header> - An additional HTTP Header to include when sending requests
- Headers
[]Xmatters
Notification Headers Header - An additional HTTP Header to include when sending requests
- headers list(object)
- An additional HTTP Header to include when sending requests
- headers
List<Xmatters
Notification Headers Header> - An additional HTTP Header to include when sending requests
- headers
Xmatters
Notification Headers Header[] - An additional HTTP Header to include when sending requests
- headers
Sequence[Xmatters
Notification Headers Header] - An additional HTTP Header to include when sending requests
- headers List<Property Map>
- An additional HTTP Header to include when sending requests
XmattersNotificationHeadersHeader, XmattersNotificationHeadersHeaderArgs
- Name string
- The name of the HTTP header.
- Secret
Value string - The secret value of the HTTP header. May contain an empty value.
- Value string
- The value of the HTTP header. May contain an empty value.
- Name string
- The name of the HTTP header.
- Secret
Value string - The secret value of the HTTP header. May contain an empty value.
- Value string
- The value of the HTTP header. May contain an empty value.
- name string
- The name of the HTTP header.
- secret_
value string - The secret value of the HTTP header. May contain an empty value.
- value string
- The value of the HTTP header. May contain an empty value.
- name String
- The name of the HTTP header.
- secret
Value String - The secret value of the HTTP header. May contain an empty value.
- value String
- The value of the HTTP header. May contain an empty value.
- name string
- The name of the HTTP header.
- secret
Value string - The secret value of the HTTP header. May contain an empty value.
- value string
- The value of the HTTP header. May contain an empty value.
- name str
- The name of the HTTP header.
- secret_
value str - The secret value of the HTTP header. May contain an empty value.
- value str
- The value of the HTTP header. May contain an empty value.
- name String
- The name of the HTTP header.
- secret
Value String - The secret value of the HTTP header. May contain an empty value.
- value String
- The value of the HTTP header. May contain an empty value.
Package Details
- Repository
- dynatrace pulumiverse/pulumi-dynatrace
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
dynatraceTerraform Provider.
published on Tuesday, Jun 9, 2026 by Pulumiverse