Leave
Triggered when a member leaves the server
Event Type
"member.leave"Description
This event is triggered whenever a member leaves your server, whether they left on their own, were kicked, or were banned. Bots are ignored.
Payload Structure
Prop
Type
Example Payload
{
"type": "member.leave",
"payload": {
"userId": "713115896805064856",
"username": "johndoe",
"memberCount": 1249
}
}Example Usage
app.post('/webhook', (req, res) => {
const { type, payload } = req.body;
if (type === 'member.leave') {
console.log(`Member left: ${payload.username}`);
console.log(`User ID: ${payload.userId}`);
console.log(`Member count: ${payload.memberCount}`);
// Update member records in your database
await recordMemberLeave({
userId: payload.userId,
username: payload.username,
leftAt: new Date(),
});
// Trigger off-boarding or win-back workflows
await handleMemberLeave(payload.userId);
}
res.status(200).send('OK');
});Use Cases
- Keep an external CRM or database in sync when members leave
- Track churn and retention over time
- Trigger win-back or follow-up workflows
- Log member departures for analytics and auditing
- Revoke external access tied to server membership