🎉 Tickety V3 has now been released! Read more →
APIHTTP EventsVerification Events

Pass

Triggered when a user passes verification

Event Type

"verification.pass"

Description

This event is triggered when a user successfully completes the verification process.

Payload Structure

Prop

Type

Example Payload

{
  "type": "verification.pass",
  "payload": {
    "verificationId": "VER-9012",
    "userId": "713115896805064856",
    "status": "VERIFIED"
  }
}

Example Usage

app.post('/webhook', (req, res) => {
  const { type, payload } = req.body;

  if (type === 'verification.pass') {
    console.log(`User ${payload.userId} passed verification!`);
    console.log(`Verification ID: ${payload.verificationId}`);
    
    // Update user status in your database
    await updateUserStatus({
      userId: payload.userId,
      verified: true,
      verificationId: payload.verificationId,
      verifiedAt: new Date(),
    });
    
    // Grant access to verified-only channels
    await grantVerifiedRole(payload.userId);
    
    // Send welcome message
    await sendWelcomeMessage(payload.userId);
  }

  res.status(200).send('OK');
});

Use Cases

  • Automatically grant verified roles or permissions
  • Track verification success rates
  • Send custom welcome messages to verified users
  • Update user records in external systems
  • Trigger onboarding workflows for verified members
  • Log verification for compliance and auditing

On this page