1. Packages
  2. Packages
  3. Dynatrace
  4. API Docs
  5. XmattersNotification
Viewing docs for Dynatrace v0.36.0
published on Tuesday, Jun 9, 2026 by Pulumiverse
dynatrace logo
Viewing docs for Dynatrace v0.36.0
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.XmattersNotification downloads 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.XmattersNotificationHeaders
    A list of the additional HTTP headers.
    Insecure bool
    Accept any SSL certificate (including self-signed and invalid certificates)
    LegacyId 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 XmattersNotificationHeadersArgs
    A list of the additional HTTP headers.
    Insecure bool
    Accept any SSL certificate (including self-signed and invalid certificates)
    LegacyId 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 XmattersNotificationHeaders
    A list of the additional HTTP headers.
    insecure Boolean
    Accept any SSL certificate (including self-signed and invalid certificates)
    legacyId 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 XmattersNotificationHeaders
    A list of the additional HTTP headers.
    insecure boolean
    Accept any SSL certificate (including self-signed and invalid certificates)
    legacyId 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 XmattersNotificationHeadersArgs
    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)
    legacyId 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) -> XmattersNotification
    func 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.
    The following state arguments are supported:
    Active bool
    This setting is enabled (true) or disabled (false)
    Headers Pulumiverse.Dynatrace.Inputs.XmattersNotificationHeaders
    A list of the additional HTTP headers.
    Insecure bool
    Accept any SSL certificate (including self-signed and invalid certificates)
    LegacyId 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 XmattersNotificationHeadersArgs
    A list of the additional HTTP headers.
    Insecure bool
    Accept any SSL certificate (including self-signed and invalid certificates)
    LegacyId 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 XmattersNotificationHeaders
    A list of the additional HTTP headers.
    insecure Boolean
    Accept any SSL certificate (including self-signed and invalid certificates)
    legacyId 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 XmattersNotificationHeaders
    A list of the additional HTTP headers.
    insecure boolean
    Accept any SSL certificate (including self-signed and invalid certificates)
    legacyId 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 XmattersNotificationHeadersArgs
    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)
    legacyId 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.XmattersNotificationHeadersHeader>
    An additional HTTP Header to include when sending requests
    Headers []XmattersNotificationHeadersHeader
    An additional HTTP Header to include when sending requests
    headers list(object)
    An additional HTTP Header to include when sending requests
    headers List<XmattersNotificationHeadersHeader>
    An additional HTTP Header to include when sending requests
    headers XmattersNotificationHeadersHeader[]
    An additional HTTP Header to include when sending requests
    headers Sequence[XmattersNotificationHeadersHeader]
    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.
    SecretValue 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.
    SecretValue 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.
    secretValue 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.
    secretValue 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.
    secretValue 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 dynatrace Terraform Provider.
    dynatrace logo
    Viewing docs for Dynatrace v0.36.0
    published on Tuesday, Jun 9, 2026 by Pulumiverse

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial