Magic link events

Magic link events notify you when magic link emails are sent. When a magic link event is triggered, IDaaS sends an HTTP POST request to your configured webhook URL with a JSON payload containing the event details.

Payload structure

Every magic link event payload has this structure:

{
  "id": "019cf819-6695-7231-a51e-aa3856d3b34c",
  "type": "magiclink.email.sent",
  "accountId": "fba02d5c-2f79-4cfd-91f5-6bd454e97ab3",
  "eventTime": "2026-03-16T19:22:20Z",
  "data": {
    // Event-specific data here
  }
}

The data object contains event-specific fields. See the event examples later on this page for the full data object for each event type.

Top-level fields

Field	Type	Description
id	string	Unique identifier for this webhook delivery
type	string	The event that occurred (for example, magiclink.email.sent)
accountId	string	Your account identifier
eventTime	string	When the event occurred (ISO 8601 format)
data	object	Details about what happened (varies by event type)

Event types

magiclink.email.sent

Triggered when a magic link email is sent.

Example payload:

{
  "id": "019cf819-6695-7231-a51e-aa3856d3b34c",
  "type": "magiclink.email.sent",
  "accountId": "fba02d5c-2f79-4cfd-91f5-6bd454e97ab3",
  "eventTime": "2026-03-16T19:22:20Z",
  "data": {
    "subject": "062e8a87-0e86-482a-a0ab-c6429fb599b9",
    "subjectName": "john",
    "subjectType": "USER",
    "resourceName": "Administration Portal",
    "sourceIp": "104.30.161.19",
    "subscriberAdminRoleName": "Super Administrator",
    "entityType": "MAGICLINKS",
    "entityId": "553d96a6-51ea-479b-9496-003cef589def",
    "entityName": "john",
    "entityAttributes": {
      "contactValue": "john@example.com",
      "magicLinkType": "Registration",
      "contactType": "Email"
    }
  }
}

The data object includes the following fields:

Field	Description
subject	ID of the user associated with the magic link email
subjectName	Username of the user associated with the magic link email
subjectType	Always USER
resourceName	Where the magic link email was sent from (for example, Administration Portal)
sourceIp	IP address from which the magic link email was sent
subscriberAdminRoleName	Administrator role used to send the magic link, when applicable
entityType	Always MAGICLINKS for magic link events
entityId	ID of the magic link
entityName	Name associated with the magic link
entityAttributes	Delivery details for the magic link email (see below)

The entityAttributes object includes these fields:

• contactValue - Email address that received the magic link
• magicLinkType - Magic link type that was sent
• contactType - Contact method used for the delivery