Endpoint
/api/v2/tenants/{tenantId}/integrations/install/EMAILALERTS
Path Parameters
tenantId
string

Describes the client ID or msp ID of the tenant

alertSource
object

Source of alert. Applicable only when installing category is Monitoring. Default Alert Source is taken as Custom.

alertSource.displayName
alertSource.id
alertSource.name
alertSource.techUid
category
string

Category describes the behavior of custom integration. Applicable only for Custom Integration installation. Example: If monitoring is selected as category, the integration will work as monitoring integration.

computeCredentials
object

Respose payload object

computeCredentials.autoMonitorable
computeCredentials.description
VMware details description
computeCredentials.id
VmWare
computeCredentials.name
computeCredentials.port
Port no
computeCredentials.secure
computeCredentials.uniqueId
uuid
configFiles
array

configFiles.contentURL
configFiles.id
configFiles.name
containerEngineType
string

Specify container runtime engine either Docker, ContainerD, CRI-O

credentialSet
string

Name of credentialSets. Only used for compute Integration.

deployment
string

Specify the k8s deployment environment where k8s cluster is onprem cluster or deployed using cloud provider. **Applicable to prometheus integration** : Optional to specify the deployment environment where the Prometheus agent will be installed.

description
string

direction
string

Direction of the installation. Applicable only when installing category is Collaboration. The default direction is taken as Inbound-Outbound.

displayName
string

Name used to identify the integration.

emailAddress
string

emailProps
array

emailProps.identifier
Unique value of a set.Email data identifies the set with this identifier and parses with the respective parsing conditions.
emailProps.identifierSource
Source for considering the unique value. Supported Values: EMAIL_SUBJECT, EMAIL_CONTENT, DEFAULT_VALUE.
emailProps.name
Name of parsing conditions set.
emailProps.properties
id
string

inboundConfig
object

inboundConfig.authentication
inboundConfig.discoveryProfile
inboundConfig.dropAlerts
Configure to drop alerts from UnManaged resources.
inboundConfig.entityTypes
Type of supported service desk entities (INCIDENT,CHANGE,SERVICEREQUEST,PROBLEM) using WEBHOOK only.
inboundConfig.mapAttributes
inboundConfig.webhookUris
installedBy
string

installedTime
string

integration
object

integration.id
integration.manifest
Defines the manifest profile of the app
integration.multipleInstallations
integration.name
ipAddress
string

ipAddress for the private cloud. To be only used for compute Integration.

logos
object

logos.file
Base64 code file of the logo.
logos.name
outboundConfig
object

outboundConfig.baseNotifier
The fields are required unless specific to an `authType`.
outboundConfig.mapAttributes
parentIntg
object

parentIntg.id
status
string

ticketType
string

OpsRamp supports the following ticket types:

{
  "displayName": "Email Alerts Integration",
  "emailProps": [
    {
      "identifier": "identify",
      "identifierSource": "EMAIL_CONTENT",
      "name": "test set 1",
      "properties": [
        {
          "condition": {
            "contentSource": "EMAIL_CONTENT",
            "endValue": "value2",
            "operator": "BETWEEN",
            "startValue": "value1"
          },
          "defaultValue": "OK",
          "name": "Alert State"
        },
        {
          "condition": {
            "contentSource": "EMAIL_CONTENT",
            "endValue": "value2",
            "operator": "BETWEEN",
            "startValue": "value1"
          },
          "name": "Service Name"
        },
        {
          "condition": {
            "contentSource": "EMAIL_CONTENT",
            "endValue": "value2",
            "operator": "BETWEEN",
            "startValue": "value1"
          },
          "name": "Device Host Name"
        }
      ]
    }
  ],
  "inboundConfig": {
    "dropAlerts": true
  },
  "logo": {
    "file": "zWc/aG7Ws5nifQL0cHF6fxW8vRwcXp/Ffyky7HaICAgIXNbBkr5hzWwZK+YY9FmJ/FLppwpn45SvJ2S4oBaNgBAQEBAQEBAQEBAQEBAQEBAQf//Z ",
    "name": "logo.png"
  }
}

Responses

OK

alertSource
object

Source of alert. Applicable only when installing category is Monitoring. Default Alert Source is taken as Custom.

alertSource.displayName
alertSource.id
alertSource.name
alertSource.techUid
category
string

Category describes the behavior of custom integration. Applicable only for Custom Integration installation. Example: If monitoring is selected as category, the integration will work as monitoring integration.

computeCredentials
object

Respose payload object

computeCredentials.autoMonitorable
computeCredentials.description
VMware details description
computeCredentials.id
VmWare
computeCredentials.name
computeCredentials.port
Port no
computeCredentials.secure
computeCredentials.uniqueId
uuid
configFiles
array

configFiles.contentURL
configFiles.id
configFiles.name
containerEngineType
string

Specify container runtime engine either Docker, ContainerD, CRI-O

credentialSet
string

Name of credentialSets. Only used for compute Integration.

deployment
string

Specify the k8s deployment environment where k8s cluster is onprem cluster or deployed using cloud provider. **Applicable to prometheus integration** : Optional to specify the deployment environment where the Prometheus agent will be installed.

description
string

direction
string

Direction of the installation. Applicable only when installing category is Collaboration. The default direction is taken as Inbound-Outbound.

displayName
string

Name used to identify the integration.

emailAddress
string

emailProps
array

emailProps.identifier
Unique value of a set.Email data identifies the set with this identifier and parses with the respective parsing conditions.
emailProps.identifierSource
Source for considering the unique value. Supported Values: EMAIL_SUBJECT, EMAIL_CONTENT, DEFAULT_VALUE.
emailProps.name
Name of parsing conditions set.
emailProps.properties
id
string

inboundConfig
object

inboundConfig.authentication
inboundConfig.discoveryProfile
inboundConfig.dropAlerts
Configure to drop alerts from UnManaged resources.
inboundConfig.entityTypes
Type of supported service desk entities (INCIDENT,CHANGE,SERVICEREQUEST,PROBLEM) using WEBHOOK only.
inboundConfig.mapAttributes
inboundConfig.webhookUris
installedBy
string

installedTime
string

integration
object

integration.id
integration.manifest
Defines the manifest profile of the app
integration.multipleInstallations
integration.name
ipAddress
string

ipAddress for the private cloud. To be only used for compute Integration.

logos
object

logos.file
Base64 code file of the logo.
logos.name
outboundConfig
object

outboundConfig.baseNotifier
The fields are required unless specific to an `authType`.
outboundConfig.mapAttributes
parentIntg
object

parentIntg.id
status
string

ticketType
string

OpsRamp supports the following ticket types:

{
  "displayName": "email alerts test from api try 44",
  "emailAddress": "alerts@5JHqWy4h34xXDwN2gYFtmaYx.opsramp.com",
  "emailProps": [
    {
      "identifier": ".",
      "identifierSource": "EMAIL_CONTENT",
      "name": "test set 1",
      "properties": [
        {
          "condition": {
            "contentSource": "EMAIL_CONTENT",
            "endValue": "value2",
            "operator": "BETWEEN",
            "startValue": "value1"
          },
          "defaultValue": "OK",
          "name": "Alert State"
        },
        {
          "condition": {
            "contentSource": "EMAIL_CONTENT",
            "endValue": "value2",
            "operator": "BETWEEN",
            "startValue": "value1"
          },
          "name": "Service Name"
        },
        {
          "condition": {
            "contentSource": "EMAIL_CONTENT",
            "endValue": "value2",
            "operator": "BETWEEN",
            "startValue": "value1"
          },
          "name": "Device Host Name"
        }
      ]
    }
  ],
  "id": "INTG-d9b99937-7906-42c7-955c-68a237144ac7",
  "inboundConfig": {
    "dropAlerts": true
  },
  "integration": {
    "id": "Email Alerts",
    "name": "Email Alerts"
  }
}