Skip to main content

Unsuccessful Login Attempt webhook payload

Unlike most other webhook types, the Unsuccessful Login Attempt webhook does not have a resource.url (the value is null) because unsuccessful login attempts do not correspond to a retrievable API resource.

When this webhook fires

  • Unsuccessful Login Attempt Added — When a user fails to authenticate (for example, by entering an incorrect password).

Content payload

When an Unsuccessful Login Attempt:Added webhook is triggered, the content section of the payload includes the following attributes:

AttributeTypeDescription
userEmailStringThe email address that was used in the failed login attempt.
ipAddressStringThe IP address from which the failed login attempt originated.
partnerStringThe identifier of the marketplace (tenant) where the failed login attempt occurred.
attemptedAtStringThe timestamp of the failed login attempt, in ISO 8601 format (for example, 2026-03-15T14:30:00Z). May be null if the timestamp is unavailable.
failedAttemptCountIntegerThe total number of consecutive failed login attempts for this user. This count resets after a successful login.

Example payload

{
"uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"timestamp": 1742054400000,
"resource": {
"type": "UNSUCCESSFUL_LOGIN_ATTEMPT",
"uuid": null,
"url": null,
"content": {
"userEmail": "johndoe@example.com",
"ipAddress": "192.168.1.100",
"partner": "ACME",
"attemptedAt": "2026-03-15T14:30:00Z",
"failedAttemptCount": 3
}
},
"resourceAction": "ADDED"
}

Was this page helpful?