> ## Documentation Index
> Fetch the complete documentation index at: https://docs.megaport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks API Event Reference Overview

> This help topic describes the structure of the JSON payload for webhooks.

When you create a webhook subscription, you specify the event types for which you want to receive notifications.

When a webhook is triggered, your configured endpoint will receive an HTTP POST request with a JSON payload containing details about the event that occurred.

The structure of the JSON payload will vary depending on the event type, but it will always include these fields:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
    "type": "security.login.failed",
    "schema_version": "1",
    "timestamp": "2026-01-15T10:30:00Z",
    "company_uid": "your-company-uuid",
    "data": {
        // event-specific fields
    }
}
```

The fields in the JSON payload are described below:

| Field           | Description                                             |
| --------------- | ------------------------------------------------------- |
| type            | The event code identifying what happened                |
| schema\_version | Payload schema version (currently "1")                  |
| timestamp       | ISO 8601 timestamp of when the event occurred           |
| company\_uid    | The company UUID that the event relates to              |
| data            | Event-specific payload — structure varies by event type |

## Event-specific data

For more details about the event-specific fields included in the `data` object for each event type, see the following:

* [Billing Events](/api/webhooks/events/billing)
* [Maintenance Events](/api/webhooks/events/maintenance)
* [Order Events](/api/webhooks/events/order)
* [Outage Events](/api/webhooks/events/outage)
* [Payment Events](/api/webhooks/events/payment)
* [Security Events](/api/webhooks/events/security)
* [Service Events](/api/webhooks/events/service)
* [User Events](/api/webhooks/events/user)

## Managing webhooks using the API

To manage your webhooks programmatically, you can use the [Webhooks API](https://dev.megaport.com/#05a836f0-0294-4d88-bf7b-f81325845a6d) to create, update, and delete webhook subscriptions, list webhooks, and list available event types.