# Pass (/api/events/verification/pass)



## Event Type [#event-type]

```ts
"verification.pass"
```

## Description [#description]

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

## Payload Structure [#payload-structure]

<TypeTable
  type="{
  verificationId: {
    description: 'Unique identifier for the verification attempt',
    type: 'string',
  },
  userId: {
    description: 'Discord user ID of who completed verification',
    type: 'string',
  },
  status: {
    description: 'New verification status (will be &#x22;VERIFIED&#x22;)',
    type: 'string',
  },
}"
/>

## Example Payload [#example-payload]

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

## Example Usage [#example-usage]

```ts
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 [#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
