Skip to main content

Setting up the webhook

The webhook is the URL that the Metric server will use to send the collected data to your server. To receive the data, you need to set up a webhook URL in the dashboard.

Webhook configuration

When you create your app on the Metric dashboard, you can configure the webhook URL that the Metric server will use to send the data. You can edit the webhook URL later if needed.

The data sent through the webhook will be in a unified format, regardless of the platform it comes from. The format is designed to be easy to use and understand.

Webhook request details

The data is sent through a POST request to the webhook URL that you provided. The POST body will be in JSON format, described on the next page.

The server expects a 200 status code as a response to the POST request. If the webhook fails to respond with a 200 status code, the request will be considered a failure and retried. Refer to webhook failures for more details.

Processing the webhook data

Once your server receives the data through the webhook, you can process it as needed. We recommend processing the data asynchronously, as the data can be quite large and processing it synchronously could cause your server to become unresponsive.

Once you have validated the data, you should return a response to the webhook request. The response should be a 200 status code with an empty body. This lets the Metric server know that your server has successfully received and processed the data.

All the health data received from various sources is being sent to the webhook configured as a POST request. We expect a successful response with status code 200.