Webhook Management
ManageEngine ADManager Plus' webhook templates enable you to create a template to configure REST API endpoints, headers, params, action type and messages, which can then be added to your orchestration templates as blocks. The webhook history allows you to retrieve webhook details, such as the associated orchestration template and monitor changes, enabling the detection of anomalies.
Steps to create a new webhook template
- Log on to ADManager Plus as the admin.
- Navigate to Automation tab → Configuration → Orchestration Template.
- Click Configure Webhook and select Create New Template.
- Enter a suitable Name and Description for the template.
- In the URL field, enter the API call. Refer to this note to learn how to utilize macros.
- In the Authorization field, select the custom application associated with the required authorization.
Note: To add a new authorization type, include the custom application for it and apply it in this section.
Click here to learn more about adding a custom application.
- In the Method field, select one of the following HTTP methods,
- Get: To read
- Put: To update or replace
- Post: To create
- Delete: To delete
- In the Headers field, you can add the required API headers and map them to the suitable header values.
- Likewise, in the Parameters field, you can add the suitable API parameters and map them to their parameter values.
- Choose the suitable Message Type option.
- Select Test and Save to check the webhook implementation in real-time for specific users and groups, or simply click Save.
Note:
- Utilize macros in the URL, Parameters, Headers, and Message fields to retrieve object-based data. Add macros from AD (including custom LDAP attributes), Microsoft 365, environment variables, and Action Details by typing % to narrow down the search for the required attribute. Alternatively, you can click the icon and choose the attribute. For additional information on creating an environment variable, click here.
- In the value fields, input %% to represent the % symbol.
- To access and utilize AD-specific macros, enter the value in %ad.attribute_name% format (for example, %ad.SamAccountName%).
- To access and utilize macros specific to Microsoft 365, enter the value in %m365.attribute_name% format (for example, %m365.UserPrincipalName%).
- To access and utilize environment variables as macros, enter the value in %env.attribute_name% format (for example, %env.ticketingtoolAuthToken%).
- To access and utilize Action Details as macros like Timestamp or Technician Name, enter the value in %act.Timestamp% or %act.technician% format (for example, %act.timestamp_dd-MM-yy_current time%).