Webhooks in iMonnit can be configured to deliver JSON data to a Webhook endpoint. If an issue occurs that prevents the Webhook from delivering to your configured Webhook for 100 attempts; the Webhook is disabled. When this occurs, a User will need to manually reset the Webhook to start sending again.
Note: For accounts that have frequent and persistent issues delivering Webhooks to the endpoint, a User may need to contact email@example.com to reenable the Webhook if the following steps are unsuccessful.
Confirm HX Credits are not consumed
If you have iMonnit HX enabled, and your HX Credits have been entirely consumed (see the “If you run out of iMonnit HX Credits” section of the iMonnit HX article), access to your data will be restricted, and your Webhooks will be disabled.
In this scenario, you will not need to use the Reset Broken feature. You will either need to simply purchase more HX Credits or reach out to firstname.lastname@example.org to have iMonnit HX disabled for the account.
Steps to Reset Broken Webhook in iMonnit Online:
- Log into the iMonnit Online Portal with a User with adequate permissions to access the Webhooks section of the site.
- Select the <>API option in the main navigation menu.
- Select Data Webhook.
- Select the Configure button toward the right-hand side of the page.
View Full Size
- Select the Reset Broken button toward the right-hand side of the page.
View Full Size
At this point, your Webhooks will attempt to start sending with the applied configurations. The data will be received if the endpoint is correctly configured and prepared to receive Webhooks. If issues persist, the Webhooks may be disabled again. Be sure to resolve any issues with the endpoint or configuration to ensure the endpoint is prepared to receive the Webhooks.
Reset using the REST API
You can also reset Webhooks using the REST API call, WebHookResetBroken. Details for this method can be found in the REST API section of iMonnit Online and are included below.
APIs use authorization to ensure that client requests access data securely. The APIKeyID and the APISecretKey both need to be included as headers in the posted request.
Resets the send count of the Webhook to have it attempt to resend subscriptions again.
Example: Example Output:
<?xml version="1.0" encoding="utf-8" ?> <SensorRestAPI xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <Method>WebHookResetBroken</Method> <Result xsi:type="xsd:string">Success</Result> </SensorRestAPI>