Changes made in the Portal or Server API
By default, authenticator events are sent only for changes the user makes, plusauthenticator.expired. You can opt in to also receive events for changes an admin makes in the Authsignal Portal or your backend makes through the Server API.
To opt in, select All events under Events to send in the Webhooks section of tenant settings. With the Management API, set authenticatorEventsWebhookConfig.includeEventsInitiatedBy when you update the tenant.
Custom data points
Authenticator events can include values from your custom data points indata.customVariables, the same field that email.created uses.
To include them:
- Register the data points you want to include as custom data points.
- In Tenant settings, open Webhooks.
- Under Authenticator events webhook URL, select Include custom data points.
- Select the data points to include, then save.
customVariables is the data point’s name, prefixed by its source:
- User data points are prefixed with
user_, such asuser_accountId. - Action data points are prefixed with
action_, such asaction_transactionAmount.
customVariables field.
Action data points come from the action’s custom data, so an event carries them only if it happened during an action. Those events include actionCode and idempotencyKey. authenticator.expired never happens during an action, so it carries only user data points.
authenticatorEventsWebhookConfig.allowedCustomVariables when you update the tenant. List Custom Data Points returns each data point’s ID. To keep the stored list, omit allowedCustomVariables. To stop including custom data points, send an empty array.
