Outage Webhook Events
This topic describes the outage events sent by Megaport’s webhooks.
outage.advised
outage.advised is sent when an outage is being investigated.
The payload of this event has the following structure:
company_uid(string, UUID)metadata(object)environment(string)
schema_version(string)timestamp(string, date-time)type(string)data(object)advisory_message(string)company_uid(string, UUID)label(string)outage_uid(string, UUID)service_uids(array of string, UUID)
For example:
{
"company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
"metadata": {
"environment": "production"
},
"schema_version": "1",
"timestamp": "2026-04-23T10:29:12Z",
"type": "outage.advised",
"data": {
"advisory_message": "Carrier reports estimated repair time of two hours.",
"company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
"label": "Sydney metro fibre cut affecting MCR2-SYD1.",
"outage_uid": "9f2c1f3e-7b9d-4f6a-8c11-9e9b1234abcd",
"service_uids": [
"3a8c0b2d-7f44-49ab-9a85-2bcd9e012345"
]
}
}
outage.closed
outage.closed is sent when an outage has been resolved.
The payload of this event has the following structure:
company_uid(string, UUID)metadata(object)environment(string)
schema_version(string)timestamp(string, date-time)type(string)data(object)company_uid(string, UUID)label(string)outage_uid(string, UUID)purpose(string)resolved_at(string, date-time)service_uids(array of string, UUID)started_at(string, date-time)
For example:
{
"company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
"metadata": {
"environment": "production"
},
"schema_version": "1",
"timestamp": "2026-04-23T10:29:12Z",
"type": "outage.closed",
"data": {
"company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
"label": "Sydney metro fibre cut affecting MCR2-SYD1.",
"outage_uid": "9f2c1f3e-7b9d-4f6a-8c11-9e9b1234abcd",
"purpose": "Carrier outage between Sydney CBD and North Sydney.",
"resolved_at": "2026-04-29T16:08:00Z",
"service_uids": [
"3a8c0b2d-7f44-49ab-9a85-2bcd9e012345"
],
"started_at": "2026-04-29T14:21:00Z"
}
}
outage.notice
outage.notice is sent when an outage has been reported.
The payload of this event has the following structure:
company_uid(string, UUID)metadata(object)environment(string)
schema_version(string)timestamp(string, date-time)type(string)data(object)company_uid(string, UUID)description(string)label(string)next_update_note(string)notice_uid(string, UUID)outage_uid(string, UUID)service_uids(array of string, UUID)
For example:
{
"company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
"metadata": {
"environment": "production"
},
"schema_version": "1",
"timestamp": "2026-04-23T10:29:12Z",
"type": "outage.notice",
"data": {
"company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
"description": "Engineers are still investigating. Customers should expect intermittent BGP flaps in SYD2 until at least 02:30 UTC.",
"label": "SYD2 transit instability.",
"next_update_note": "Awaiting upstream carrier response before issuing the next update.",
"notice_uid": "f4e3d2c1-b0a9-4988-7766-554433221100",
"outage_uid": "1f4e7c0a-2b3d-4e5f-6a7b-8c9d0e1f2a3b",
"service_uids": [
"3a8c0b2d-7f44-49ab-9a85-2bcd9e012345"
]
}
}
outage.reopened
outage.reopened is sent when an outage is reopened.
The payload of this event has the following structure:
company_uid(string, UUID)metadata(object)environment(string)
schema_version(string)timestamp(string, date-time)type(string)data(object)company_uid(string, UUID)label(string)outage_uid(string, UUID)purpose(string)reopened_at(string, date-time)service_uids(array of string, UUID)
For example:
{
"company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
"metadata": {
"environment": "production"
},
"schema_version": "1",
"timestamp": "2026-04-23T10:29:12Z",
"type": "outage.reopened",
"data": {
"company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
"label": "Sydney metro fibre cut affecting MCR2-SYD1.",
"outage_uid": "9f2c1f3e-7b9d-4f6a-8c11-9e9b1234abcd",
"purpose": "Issue recurred after the initial fix; investigation continues.",
"reopened_at": "2026-04-29T18:42:00Z",
"service_uids": [
"3a8c0b2d-7f44-49ab-9a85-2bcd9e012345"
]
}
}
outage.resolved
outage.resolved is sent when an outage has been resolved.
The payload of this event has the following structure:
company_uid(string, UUID)metadata(object)environment(string)
schema_version(string)timestamp(string, date-time)type(string)data(object)company_uid(string, UUID)label(string)mitigation_actions(string)outage_uid(string, UUID)resolution(string)resolved_at(string, date-time)root_cause(string)service_uids(array of string, UUID)started_at(string, date-time)
For example:
{
"company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
"metadata": {
"environment": "production"
},
"schema_version": "1",
"timestamp": "2026-04-23T10:29:12Z",
"type": "outage.resolved",
"data": {
"company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
"label": "Sydney metro fibre cut affecting MCR2-SYD1.",
"mitigation_actions": "Traffic rerouted via alternate path; affected card replaced.",
"outage_uid": "9f2c1f3e-7b9d-4f6a-8c11-9e9b1234abcd",
"resolution": "Carrier completed splice repair on the affected fibre.",
"resolved_at": "2026-04-29T16:08:00Z",
"root_cause": "Third-party fibre cut by civil works contractor.",
"service_uids": [
"3a8c0b2d-7f44-49ab-9a85-2bcd9e012345"
],
"started_at": "2026-04-29T14:21:00Z"
}
}
outage.started
outage.started is sent when an outage event has been started.
The payload of this event has the following structure:
company_uid(string, UUID)metadata(object)environment(string)
schema_version(string)timestamp(string, date-time)type(string)data(object)company_uid(string, UUID)label(string)outage_uid(string, UUID)purpose(string)service_uids(array of string, UUID)started_at(string, date-time)
For example:
{
"company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
"metadata": {
"environment": "production"
},
"schema_version": "1",
"timestamp": "2026-04-23T10:29:12Z",
"type": "outage.started",
"data": {
"company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
"label": "Sydney metro fibre cut affecting MCR2-SYD1.",
"outage_uid": "9f2c1f3e-7b9d-4f6a-8c11-9e9b1234abcd",
"purpose": "Carrier outage between Sydney CBD and North Sydney.",
"service_uids": [
"3a8c0b2d-7f44-49ab-9a85-2bcd9e012345"
],
"started_at": "2026-04-29T14:21:00Z"
}
}