Security Webhook Events - Megaport Documentation

This topic describes the security events sent by Megaport’s webhooks. security.login.failed is sent when a failed login attempt occurred. 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)
- account_locked (boolean)
- attempts (integer, int32)
- email (string, email)
- person_uid (string, UUID)

For example:

{
  "company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
  "metadata": {
    "environment": "production"
  },
  "schema_version": "1",
  "timestamp": "2026-04-23T10:29:12Z",
  "type": "security.login.failed",
  "data": {
    "account_locked": false,
    "attempts": 3,
    "email": "jane.doe@example.com",
    "person_uid": "c1135358-29fa-4b0f-9742-ba4bc4c22e1a"
  }
}

security.password.reset_requested

security.password.reset_requested is sent when a password reset was requested. 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)
- email (string, email)
- person_uid (string, UUID)

For example:

{
  "company_uid": "681ef39b-436b-40dd-a914-26391db2689c",
  "metadata": {
    "environment": "production"
  },
  "schema_version": "1",
  "timestamp": "2026-04-23T10:29:12Z",
  "type": "security.password.reset_requested",
  "data": {
    "email": "jane.doe@example.com",
    "person_uid": "c1135358-29fa-4b0f-9742-ba4bc4c22e1a"
  }
}

​security.login.failed

​security.password.reset_requested

security.login.failed

security.password.reset_requested