Endpoint
/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}/event/{eventId}
Path Parameters
tenantId
string

Describes the client ID or msp ID of the tenant

installedIntgId
string

Unique Identifier of the installed integration

eventId
string

The unique ID of an event related to the integration

Responses

OK

Endpoint
/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}/event/{eventId}
Path Parameters
tenantId
string

Describes the client ID or msp ID of the tenant

installedIntgId
string

Unique Identifier of the installed integration

eventId
string

The unique ID of an event related to the integration

Responses

OK

depEvent
object

depEvent.depEndPointURI
depEvent.headers
depEvent.payload
depEvent.responseHeaders
endPointURI
string

entity
string

Entity on which an action is performed. Supported entities include: Service Desk INCIDENT SERVICEREQUEST CHANGE PROBLEM TASK Resource Alert ALERT (used only when eventType is selected as NONE)

eventType
string

Type of action performed on the entity. Supported values include: NONE (Used to invoke external integration through process workflow), CREATE, UPDATE, DELETE

filterCriteria
object

Filter entities on which the event is added to the rules

filterCriteria.actions
filterCriteria.id
filterCriteria.matchType
Match All or Any of the rules.
filterCriteria.name
filterCriteria.rules
Rules to filter the entities
headers
array

headers.key
headers.value
id
string

name
string

Name of the Integration event.

notifier
object

The fields are required unless specific to an `authType`.

notifier.accessTokenURL
Access Token URL: Mandatory if authType is OAUTH2.
notifier.apiKey
API Key: Mandatory if authType is OAUTH2.
notifier.apiSecret
API Secret: Mandatory if authType is OAUTH2.
notifier.authType
Authentication type.
notifier.baseURI
notifier.grantType
Grant type for notification.
notifier.password
Password: Mandatory when authType is OAUTH2 and grantType is PASSWORD/REFRESH_TOKEN.
notifier.resourceAuthHeaders
(JWT only) Authorization header for resource calls.
notifier.tokenHeaders
(JWT only) Headers to request the token.
notifier.tokenPayload
(JWT only) Payload for the token.
notifier.tokenURL
(JWT only) Access token URI.
notifier.tokensPath
(JWT only) Token path in the response of the authentication REST call.
notifier.type
Notification type.
notifier.userName
Username: Mandatory when authType is OAUTH2 and grantType is PASSWORD/REFRESH_TOKEN.
payload
string

Third-party integration event payload. Provide the third-party payload with OpsRamp placeholders to integrate the event between OpsRamp and third-party: - To get OpsRamp tokens, use refer to the Get Integration Event Placeholders API. - Convert the payload to base 64 and provide the file in the field file in the below sample request.

responseHeaders
array

responseHeaders.key
responseHeaders.value
thirdPartyEventType
string

Type of action performed on the entity.Supported Values: POST, PUT, GET, DELETE, and PATCH

useBaseNotifier
boolean

Notification details to trigger events defined. To configure integration base notifier: - Provide useBaseNotifier: true to assign the notifier details to the event. - Provide useBaseNotifier: false to assign different notifier details

{
  "depEvent": {
    "depEndPointURI": "https://urportal.com/create/tkt/attachment",
    "headers": [
      {
        "key": "Accept",
        "value": "application/json"
      },
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "payload": "{\n'attach':'$attach.id'\n}",
    "responseHeaders": [
      {
        "key": "id",
        "value": "$attch.id"
      }
    ]
  },
  "entity": "INCIDENT",
  "headers": [
    {
      "key": "Accept",
      "value": "application/json"
    },
    {
      "key": "Content-Type",
      "value": "application/json"
    }
  ],
  "id": "INTG-EVENT-0e85ed91-35b7-4fe8-a702-45fab935961c",
  "name": "Ticket create event",
  "notifier": {
    "baseURI": "https://urportal.com/create/tkt"
  },
  "payload": "{\n'subject':'$incident.subject',\n'description':'$incident.impact',\n'priority':'$incident.priority.name'\n}",
  "responseHeaders": [
    {
      "key": "extTicketId",
      "value": "$id"
    },
    {
      "key": "Error Message",
      "value": "$err"
    }
  ]
}
Endpoint
/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}/event/{eventId}
Path Parameters
tenantId
string

Describes the client ID or msp ID of the tenant

installedIntgId
string

Unique Identifier of the installed integration

eventId
string

The unique ID of an event related to the integration

depEvent
object

depEvent.depEndPointURI
depEvent.headers
depEvent.payload
depEvent.responseHeaders
endPointURI
string

entity
string

Entity on which an action is performed. Supported entities include: Service Desk INCIDENT SERVICEREQUEST CHANGE PROBLEM TASK Resource Alert ALERT (used only when eventType is selected as NONE)

eventType
string

Type of action performed on the entity. Supported values include: NONE (Used to invoke external integration through process workflow), CREATE, UPDATE, DELETE

filterCriteria
object

Filter entities on which the event is added to the rules

filterCriteria.actions
filterCriteria.id
filterCriteria.matchType
Match All or Any of the rules.
filterCriteria.name
filterCriteria.rules
Rules to filter the entities
headers
array

headers.key
headers.value
id
string

name
string

Name of the Integration event.

notifier
object

The fields are required unless specific to an `authType`.

notifier.accessTokenURL
Access Token URL: Mandatory if authType is OAUTH2.
notifier.apiKey
API Key: Mandatory if authType is OAUTH2.
notifier.apiSecret
API Secret: Mandatory if authType is OAUTH2.
notifier.authType
Authentication type.
notifier.baseURI
notifier.grantType
Grant type for notification.
notifier.password
Password: Mandatory when authType is OAUTH2 and grantType is PASSWORD/REFRESH_TOKEN.
notifier.resourceAuthHeaders
(JWT only) Authorization header for resource calls.
notifier.tokenHeaders
(JWT only) Headers to request the token.
notifier.tokenPayload
(JWT only) Payload for the token.
notifier.tokenURL
(JWT only) Access token URI.
notifier.tokensPath
(JWT only) Token path in the response of the authentication REST call.
notifier.type
Notification type.
notifier.userName
Username: Mandatory when authType is OAUTH2 and grantType is PASSWORD/REFRESH_TOKEN.
payload
string

Third-party integration event payload. Provide the third-party payload with OpsRamp placeholders to integrate the event between OpsRamp and third-party: - To get OpsRamp tokens, use refer to the Get Integration Event Placeholders API. - Convert the payload to base 64 and provide the file in the field file in the below sample request.

responseHeaders
array

responseHeaders.key
responseHeaders.value
thirdPartyEventType
string

Type of action performed on the entity.Supported Values: POST, PUT, GET, DELETE, and PATCH

useBaseNotifier
boolean

Notification details to trigger events defined. To configure integration base notifier: - Provide useBaseNotifier: true to assign the notifier details to the event. - Provide useBaseNotifier: false to assign different notifier details

{
  "entity": "INCIDENT",
  "eventType": "CREATE",
  "filterCriteria": {
    "id": 141,
    "matchType": "ANY",
    "rules": [
      {
        "id": 581,
        "key": "Subject",
        "operator": "Contains",
        "resourceType": "INCIDENT",
        "value": "test"
      },
      {
        "id": 582,
        "key": "Description",
        "operator": "Contains",
        "resourceType": "INCIDENT",
        "value": "testing"
      }
    ]
  },
  "headers": [
    {
      "key": "accept",
      "value": "application/json"
    },
    {
      "key": "Content-Type",
      "value": "application/json"
    }
  ],
  "name": "Create event with policy and dep updated",
  "notifier": {
    "authType": "BASIC",
    "baseURI": "www.google.com",
    "password": "test",
    "type": "SOAP_API",
    "userName": "testUser"
  },
  "payload": "ew0KInN1YmplY3QiOiIkaW5jaWRlbnQuc3ViamVjdCIsDQoiZGVzY3JpcHRpb24iOiIkaW5jaWRlbnQuaW1wYWN0IiwNCiJwcmlvcml0eSI6IiRpbmNpZGVudC5wcmlvcml0eS5uYW1lIg0KInN0YXV0cyI6ImhpZ2giDQp9",
  "thirdPartyEventType": "POST"
}

Responses

OK

depEvent
object

depEvent.depEndPointURI
depEvent.headers
depEvent.payload
depEvent.responseHeaders
endPointURI
string

entity
string

Entity on which an action is performed. Supported entities include: Service Desk INCIDENT SERVICEREQUEST CHANGE PROBLEM TASK Resource Alert ALERT (used only when eventType is selected as NONE)

eventType
string

Type of action performed on the entity. Supported values include: NONE (Used to invoke external integration through process workflow), CREATE, UPDATE, DELETE

filterCriteria
object

Filter entities on which the event is added to the rules

filterCriteria.actions
filterCriteria.id
filterCriteria.matchType
Match All or Any of the rules.
filterCriteria.name
filterCriteria.rules
Rules to filter the entities
headers
array

headers.key
headers.value
id
string

name
string

Name of the Integration event.

notifier
object

The fields are required unless specific to an `authType`.

notifier.accessTokenURL
Access Token URL: Mandatory if authType is OAUTH2.
notifier.apiKey
API Key: Mandatory if authType is OAUTH2.
notifier.apiSecret
API Secret: Mandatory if authType is OAUTH2.
notifier.authType
Authentication type.
notifier.baseURI
notifier.grantType
Grant type for notification.
notifier.password
Password: Mandatory when authType is OAUTH2 and grantType is PASSWORD/REFRESH_TOKEN.
notifier.resourceAuthHeaders
(JWT only) Authorization header for resource calls.
notifier.tokenHeaders
(JWT only) Headers to request the token.
notifier.tokenPayload
(JWT only) Payload for the token.
notifier.tokenURL
(JWT only) Access token URI.
notifier.tokensPath
(JWT only) Token path in the response of the authentication REST call.
notifier.type
Notification type.
notifier.userName
Username: Mandatory when authType is OAUTH2 and grantType is PASSWORD/REFRESH_TOKEN.
payload
string

Third-party integration event payload. Provide the third-party payload with OpsRamp placeholders to integrate the event between OpsRamp and third-party: - To get OpsRamp tokens, use refer to the Get Integration Event Placeholders API. - Convert the payload to base 64 and provide the file in the field file in the below sample request.

responseHeaders
array

responseHeaders.key
responseHeaders.value
thirdPartyEventType
string

Type of action performed on the entity.Supported Values: POST, PUT, GET, DELETE, and PATCH

useBaseNotifier
boolean

Notification details to trigger events defined. To configure integration base notifier: - Provide useBaseNotifier: true to assign the notifier details to the event. - Provide useBaseNotifier: false to assign different notifier details

{
  "entity": "INCIDENT",
  "eventPayload": "{\r\n'subject':'$incident.subject',\r\n'description':'$incident.impact',\r\n'priority':'$incident.priority.name'\r\n'stauts':'high'\r\n}",
  "filterCriteria": {
    "actions": [],
    "id": 141,
    "matchType": "ANY",
    "name": "Create event with policy and dep",
    "rules": [
      {
        "id": 581,
        "key": "Subject",
        "operator": "Contains",
        "resourceType": "INCIDENT",
        "value": "test"
      },
      {
        "id": 582,
        "key": "Description",
        "operator": "Contains",
        "resourceType": "INCIDENT",
        "value": "testing"
      }
    ]
  },
  "headers": [
    {
      "key": "accept",
      "value": "application/json"
    },
    {
      "key": "Content-Type",
      "value": "application/json"
    }
  ],
  "id": "INTG-EVENT-c6d30f9c-2728-4760-ad97-8f3b6f2b6391",
  "name": "Create event with policy and dep updated",
  "notifier": {
    "authType": "BASIC",
    "baseURI": "www.google.com",
    "userName": "testUser"
  }
}