Skip to main content
Check out our end-to-end guide on how to implement push verification using Authsignal.

​
Start a push challenge

Start a push challenge by sending a notification to the user’s mobile device. 
const response = await authsignal.push.challenge();
To target a specific enrolled push authenticator when the user has more than one, pass its userAuthenticatorId. The challenge is then sent only to that authenticator and can only be approved from that device. 
const response = await authsignal.push.challenge({
  userAuthenticatorId: "9b89d063-72c8-4a3b-9c2b-1e2f3a4b5c6d",
});

​
Parameters

​
action
string
The action being performed.
​
userAuthenticatorId
string
The ID of a specific enrolled push authenticator to target. When omitted, the challenge is sent to all of the user’s eligible push authenticators.

​
Response

​
response
AuthsignalResponse<PushChallengeResponse>

​
Check push challenge verification status

const response = await authsignal.push.verify({
  challengeId: "3a991a14-690c-492b-a5e5-02b9056a4b7d",
});

​
Parameters

​
challengeId
string
The ID of the Authsignal challenge returned when starting the push challenge.

​
Response

​
response
AuthsignalResponse<PushVerifyResponse>