Skip to main content

​
Overview

Webhooks allow you to receive real-time notifications when events occur on your Meter network. When an alert triggers, Meter sends a webhook to your configured endpoint with details about the event. Use webhooks to integrate Meter alerts with your existing monitoring systems, ticketing platforms, or custom automation workflows.

​
Prerequisites

  • Dashboard access with Admin or Network Admin permissions
  • A publicly accessible HTTPS endpoint to receive webhook payloads
  • (Optional) A secret key for payload verification

​
Use cases

  • Forward network alerts to a ticketing system (ServiceNow, Jira, etc.)
  • Trigger automated remediation workflows
  • Aggregate alerts in a centralized monitoring platform
  • Build custom dashboards and reporting tools
  • Send notifications to chat platforms (beyond Slack integration)

​
Configuring webhooks

​
Accessing webhook settings

  1. Navigate to Settings in the Dashboard sidebar
  2. Select Integrations
  3. Click the Webhooks tab
Dashboard integrations page showing the Webhooks tab

​
Adding a webhook

Add webhook configuration panel
  1. Click + Add webhook
  2. Enter a Label - a descriptive name for this webhook (e.g., “Production Alerts”)
  3. Enter the URL - the HTTPS endpoint that will receive webhook payloads
  4. (Optional) Enter a Secret - a shared secret for payload verification
  5. Select an Authorization method
  6. Choose from the dropdown: None, Basic, or Bearer
  7. Click Save to create the webhook

​
Authorization options

OptionDescription
NoneNo authentication header is sent with requests
BasicSends an Authorization: Basic <credentials> header
BearerSends an Authorization: Bearer <token> header

​
Webhook payload format

All webhook payloads follow a consistent structure with two main objects: 
{
  "metadata": {
    "alert_name": "ALERT_DEVICE_OFFLINE",
    "network_name": "Main Office",
    "timestamp": "2026-01-23T21:40:03Z"
  },
  "data": {
    // Alert-specific data
  }
}

​
Metadata fields

FieldTypeDescription
alert_namestringThe type of alert that triggered (e.g., “ALERT_DEVICE_OFFLINE”, “ALERT_WAN_DOWN”)
network_namestringThe label of the network where the event occurred
timestampstringISO 8601 timestamp of when the event occurred

​
Data fields

The data object contains alert-specific information. See the Alert events reference for detailed payload schemas for each alert type.

​
Troubleshooting

  • Verify your endpoint URL is correct and publicly accessible
  • Check that your endpoint accepts POST requests
  • Ensure any firewall rules allow traffic from Meter’s servers
  • Confirm the webhook is enabled in the Dashboard
  • For Basic auth, ensure credentials are correctly formatted
  • For Bearer auth, verify the token is valid and not expired
  • Check that your endpoint expects the authorization header format being sent
  • Ensure your endpoint correctly parses JSON request bodies
  • Verify your server can handle the payload size
  • Check server logs for parsing errors

​
Need help?

If you run into any issues or have questions, please reach out to our Support Engineering team by opening a ticket via the Dashboard: https://dashboard.meter.com/support
Last updated by Meter Support Engineering on 01/23/2026