Alert events reference [Overview of webhook event payloads sent by Meter]

Configure webhooks to receive real-time alerts from your Meter network

Webhooks


## 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


  <img src="/images/reference/webhooks/integrations-page.png" alt="Dashboard integrations page showing the Webhooks tab" />


### Adding a webhook


  <img src="/images/reference/webhooks/add-webhook.png" alt="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

| Option | Description |
|--------|-------------|
| **None** | No authentication header is sent with requests |
| **Basic** | Sends an `Authorization: Basic <credentials>` header |
| **Bearer** | Sends an `Authorization: Bearer <token>` header |

## Webhook payload format

All webhook payloads follow a consistent structure with two main objects:

```json
{
  "metadata": {
    "alert_name": "ALERT_DEVICE_OFFLINE",
    "network_name": "Main Office",
    "timestamp": "2026-01-23T21:40:03Z"
  },
  "data": {
    // Alert-specific data
  }
}
```

### Metadata fields

| Field | Type | Description |
|-------|------|-------------|
| `alert_name` | string | The type of alert that triggered (e.g., "ALERT_DEVICE_OFFLINE", "ALERT_WAN_DOWN") |
| `network_name` | string | The label of the network where the event occurred |
| `timestamp` | string | ISO 8601 timestamp of when the event occurred |

### Data fields

The `data` object contains alert-specific information. See the [Alert events reference](/reference/webhooks/alert-events) for detailed payload schemas for each alert type.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Webhook requests are not being received">
    - 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
  </Accordion>
  <Accordion title="Authentication errors">
    - 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
  </Accordion>
  <Accordion title="Payloads are malformed or incomplete">
    - Ensure your endpoint correctly parses JSON request bodies
    - Verify your server can handle the payload size
    - Check server logs for parsing errors
  </Accordion>
</AccordionGroup>

## Related resources

- [Alert events reference](/reference/webhooks/alert-events) - Detailed payload schemas for all alert types
- [How to configure alerts](/dashboard/alerts) - Set up which alerts trigger webhooks
- [Slack integration](/reference/api-and-integrations/slack-integration) - Alternative for sending alerts to Slack

## 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*


Option	Description
None	No authentication header is sent with requests
Basic	Sends an `Authorization: Basic <credentials>` header
Bearer	Sends an `Authorization: Bearer <token>` header

Field	Type	Description
`alert_name`	string	The type of alert that triggered (e.g., "ALERT_DEVICE_OFFLINE", "ALERT_WAN_DOWN")
`network_name`	string	The label of the network where the event occurred
`timestamp`	string	ISO 8601 timestamp of when the event occurred