Notifications

listNotificationProfiles

This API is used to list all the Notification Profiles created in OpManager.

HTTP Method

GET

API URL

https://localhost:8060/api/json/admin/listNotificationProfiles?apiKey=***************&isGlobal=true&profileFilter=All&deviceName=devicename

Parameters

Param NameDescriptionData TypeAllowed Values / RegexIs Mandatory
apiKeyAPI key used to authenticate and access your OpManager server.String-Yes
isGlobalBoolean flag indicating whether to fetch only global profiles.
true- Lists only global profiles.
false- Lists all device-specific profiles.
BooleanAllowed values: trueor falseNo
profileFilterSpecifies the filter used to list profiles based on the action type.StringAllowed values: All, Send Email, Send SMS, Run Program, Webhook, Log a Ticket, Chat, Send Trap, SyslogNo
deviceNameSpecifies the name of the device to check which global profiles are associated with it.
Can be retrieved using the API: listDevices.
If a profile is associated, the hasAssociatedfield in the response will be true.
String-No
groupNameSpecifies the name of the device group, if profiles are queried based on a specific group.
Can be retrieved using the API: listDeviceGroups.
StringAllowed values: Any valid device group name (supports alphanumeric text and symbols).No
profileAssociationTypeDefines the type of association between profiles and devices or groups.
Can be verified from the API response of listNotificationProfiles.
StringAllowed values: MANUAL, BY_DEVICE_GROUP, BY_INTERFACE_GROUPNo

Sample Response

HTTP Code: 200

[ { "profileName": "Play Sound", "hasSubProfiles": false, "profileType": "Run Program", "profileLabel": "Run Program", "profileID": "1", "hasCriteria": false, "isDevice": false, "status": "true"}, { "profileName": "testProfile", "hasSubProfiles": false, "profileType": "Send Email", "profileLabel": "Send Email", "profileID": "301", "isDevice": false, "hasAssociated": true, "status": "true"}]
Rate limit: 50 requests per minute. Exceeding this limit will block requests for 5 minutes

associateNotificationProfiles

This API is used to associate notification profiles to devices.

HTTP Method

POST

API URL

https://localhost:8060/api/json/admin/associateNotificationProfiles?apiKey=***************&deviceName=devicename&profiles=501

Parameters

Param NameDescriptionData TypeAllowed Values / RegexIs Mandatory
apiKeyAPI Key to access your OpManager server.  Yes
deviceNameName of the device(s) to which the notification profiles should be associated.
Can be retrieved using the API: listDevices.
StringAllowed values: Any valid device name as shown in the OpManager UI.Yes
groupNameSpecifies the name of the device group, if profiles are queried based on a specific group.
Can be retrieved using the API: listDeviceGroups.
StringAllowed values: Any valid device group name (supports alphanumeric text and symbols).No
profilesComma-separated list of Profile IDs to be associated.
Can be retrieved from the API: listNotificationProfiles.
StringAllowed values: Comma-separated numeric Profile IDs (e.g., 501,502,503).Yes

Sample Response

HTTP Code: 200

{ "result":{ "message": "Notification Profile has been associated successfully"}}
Rate limit: 50 requests per minute. Exceeding this limit will block requests for 5 minutes

updateNotificationProfileStatus

This API is used to enable/disable notification profiles. This API will be available from OpManager version 127189

HTTP Method

POST

API URL

https://localhost:8060/api/json/admin/updateNotificationProfileStatus?apiKey=***************&profileName=testprofile&profileId=301&status=disable

Parameters

Param NameDescriptionData TypeAllowed Values / RegexIs Mandatory
apiKeyAPI Key to access your OpManager server.  Yes
profileNameName of the notification profile to be enabled or disabled.
Can be retrieved from the API: listNotificationProfiles.
String-Yes
profileIdID of the notification profile that needs to be enabled or disabled.
Can be retrieved from the API: listNotificationProfiles.
Long-Yes
statusAction to perform on the profile.StringAllowed values: enable or disableYes
deviceNameName of the device if the profile update is intended for a specific device.
Can be retrieved using the API: listDevices.
String-No
isTemplateBoolean flag indicating if the profile is a template-based configuration.BooleanAllowed values: true or false.No

Sample Response

HTTP Code: 200

{"message":"Notification Profile(s) enabled successfully"} or{"message":"Notification Profile(s) disabled successfully"}
Rate limit: 500requests per minute. Exceeding this limit will block requests for 5 minutes

getNotificationProfiles

This API is used to list notification profiles specific to the device.

HTTP Method

GET

API URL

https://localhost:8060/api/json/device/getNotificationProfiles?apiKey=***************&name=devicename

Parameters

Param NameDescriptionData TypeAllowed Values / RegexIs Mandatory
apiKeyAPI Key to access your OpManager server.  Yes
nameName of the device for which the notification profiles need to be listed.
Can be retrieved using the API: listDevices.
StringAllowed values: Any valid device name as shown in the OpManager UI.Yes
groupNameSpecifies the name of the device group, if profiles are queried based on a specific group.
Can be retrieved using the API: listDeviceGroups.
StringAllowed values: Any valid device group name (supports alphanumeric text and symbols).No

Sample Response

HTTP Code: 200

[ { "profileName": "Default Notification Profile", "actionDisplayName": "Send Email", "profileLabel": "Send Email", "criteriaId": "301", "profileId": "601", "isGlobal": true, "actionName": "Send Email", "status": "true"}]
Rate limit: 500 requests per minute. Exceeding this limit will block requests for 5 minutes

Thank you for your feedback!

Was this content helpful?

We are sorry. Help us improve this page.

How can we improve this page?
Do you need assistance with this topic?
By clicking "Submit", you agree to processing of personal data according to the Privacy Policy.

Thank you for your feedback!

Was this content helpful?

We are sorry. Help us improve this page.

How can we improve this page?
Do you need assistance with this topic?
By clicking "Submit", you agree to processing of personal data according to the Privacy Policy.