Endpoint
/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}/event/{eventId}
Path Parameters
tenantIdstring
installedIntgIdstring
eventIdstring
Responses
OK
Endpoint
/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}/event/{eventId}
Path Parameters
tenantIdstring
installedIntgIdstring
eventIdstring
Responses
OK
depEventobject
Child Parameters
- depEvent.depEndPointURI
- depEvent.headers
- depEvent.payload
- depEvent.responseHeaders
endPointURIstring
entitystring
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)
eventTypestring
Type of action performed on the entity. Supported values include: NONE (Used to invoke external integration through process workflow), CREATE, UPDATE, DELETE
filterCriteriaobject
(Optional) Filter entities on which the event is added to the rules:
Child Parameters
- filterCriteria.actions
- filterCriteria.id
- filterCriteria.matchType
- Match All or Any of the rules.
- filterCriteria.name
- filterCriteria.rules
- Rules to filter the entities:
idstring
namestring
Name of the Integration event.
notifierobject
The fields are required unless specific to an `authType`.
Child Parameters
- 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.
payloadstring
(Optional) 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.
thirdPartyEventTypestring
Type of action performed on the entity.Supported Values: POST, PUT, GET, DELETE, and PATCH
useBaseNotifierboolean
(Optional) 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
tenantIdstring
installedIntgIdstring
eventIdstring
depEventobject
Child Parameters
- depEvent.depEndPointURI
- depEvent.headers
- depEvent.payload
- depEvent.responseHeaders
endPointURIstring
entitystring
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)
eventTypestring
Type of action performed on the entity. Supported values include: NONE (Used to invoke external integration through process workflow), CREATE, UPDATE, DELETE
filterCriteriaobject
(Optional) Filter entities on which the event is added to the rules:
Child Parameters
- filterCriteria.actions
- filterCriteria.id
- filterCriteria.matchType
- Match All or Any of the rules.
- filterCriteria.name
- filterCriteria.rules
- Rules to filter the entities:
idstring
namestring
Name of the Integration event.
notifierobject
The fields are required unless specific to an `authType`.
Child Parameters
- 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.
payloadstring
(Optional) 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.
thirdPartyEventTypestring
Type of action performed on the entity.Supported Values: POST, PUT, GET, DELETE, and PATCH
useBaseNotifierboolean
(Optional) 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
depEventobject
Child Parameters
- depEvent.depEndPointURI
- depEvent.headers
- depEvent.payload
- depEvent.responseHeaders
endPointURIstring
entitystring
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)
eventTypestring
Type of action performed on the entity. Supported values include: NONE (Used to invoke external integration through process workflow), CREATE, UPDATE, DELETE
filterCriteriaobject
(Optional) Filter entities on which the event is added to the rules:
Child Parameters
- filterCriteria.actions
- filterCriteria.id
- filterCriteria.matchType
- Match All or Any of the rules.
- filterCriteria.name
- filterCriteria.rules
- Rules to filter the entities:
idstring
namestring
Name of the Integration event.
notifierobject
The fields are required unless specific to an `authType`.
Child Parameters
- 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.
payloadstring
(Optional) 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.
thirdPartyEventTypestring
Type of action performed on the entity.Supported Values: POST, PUT, GET, DELETE, and PATCH
useBaseNotifierboolean
(Optional) 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"
}
}