Events schema
Events schema reference documentation.
Authsignal events are defined by two parts - the events metadata, and the event-specific data.
All Authsignal events’ metadata is the same, and the event-specific data is unique to each event.
Event metadata
A unique identifier for the event.
The source of the event. This is always https://authsignal.com
.
The time the event was created in ISO 8601 format.
The type of the event. Each type has a different schema for the data
field.
The version of the event.
The ID of the tenant that the event is intended for.
The event-specific data. See below for the schema of the data
field for each event type.
Event metadata example
Event data
Authenticator webhooks
Email magic link
The email address the magic link should be delivered to.
The URL of the magic link.
The ID of the user the magic link is for.
The idempotency key of the request that created the magic link.
The action code of the track request that created the magic link.
The user agent of the user who requested the magic link.
This is only present if the user agent was captured when tracking an action.
The timezone of the user who requested the magic link.
This is only present if the IP address was captured when tracking an action.
The IP address of the user who requested the magic link.
This is only present if the IP address was captured when tracking an action.
Email OTP
The email address the magic link should be delivered to.
The email OTP code.
The ID of the user the email OTP code is for.
The idempotency key of the request that created the email OTP.
The action code of the track request that created the email OTP.
The user agent of the user who requested the email OTP.
This is only present if the user agent was captured when tracking an action.
The timezone of the user who requested the email OTP.
This is only present if the IP address was captured when tracking an action.
The IP address of the user who requested the email OTP.
This is only present if the IP address was captured when tracking an action.
Push
The challenge ID to be completed using push notification.
The ID of the user the push challenge is for.
The idempotency key of the request that created the push notification.
The action code of the track request that created the push notification.
The user agent of the user who requested the push notification.
This is only present if the user agent was captured when tracking an action.
The timezone of the user who requested the push notification.
This is only present if the IP address was captured when tracking an action.
The IP address of the user who requested the push notification.
This is only present if the IP address was captured when tracking an action.
SMS
The phone number the SMS should be delivered to (E.164 format).
The SMS code.
The ID of the user the SMS code is for.
The idempotency key of the request that created the SMS code.
The action code of the track request that created the SMS code.
Event webhooks
Authenticator created
The ID of the user that the authenticator was created for.
The verification method of the authenticator that was created.
The time the authenticator was created in ISO 8601 format.
A uniquie ID for the user authenticator that was created.
Authenticator deleted
The ID of the user that the authenticator was deleted for.
The verification method of the authenticator that was deleted.
The time the authenticator was created in ISO 8601 format.
The time the authenticator was deleted in ISO 8601 format.
A uniquie ID for the user authenticator that was deleted.
Was this page helpful?