K
Docs
API ReferenceEvent TypesMember joins
👋

Member joins

guildMemberAddGUILD_MEMBER_ADDTrigger

Fires when a new member joins any server the bot is in.

When to use this
  • Welcome messages
  • Default role assignment
  • Logging joins to the Vault

On the canvas

This is what the trigger looks like in your bot's Triggers tab. The sparks listed are available in every node inside the linked flow.

👋
Member joins
guildMemberAdd
Trigger
Sparks in this flow
{{input.guild.id}}Your Discord server's unique ID
{{input.guild.name}}Your server's name
{{input.guild.memberCount}}How many members are in the server
{{member.id}}The new member's Discord ID
{{member.username}}Their Discord username
{{member.displayName}}Their nickname in this server, or username if none
{{member.name}}Their username (alias for member.username)
{{member.joinedAt}}When they joined (ISO timestamp)

Available sparks

Use these in any piece config field inside flows triggered by this event.

SparkTypeDescription
{{input.guild.id}}stringYour Discord server's unique ID
{{input.guild.name}}stringYour server's name
{{input.guild.memberCount}}stringHow many members are in the server
{{member.id}}stringThe new member's Discord ID
{{member.username}}stringTheir Discord username
{{member.displayName}}stringTheir nickname in this server, or username if none
{{member.name}}stringTheir username (alias for member.username)
{{member.joinedAt}}stringWhen they joined (ISO timestamp)
📐

In TypeScript, this would be…

Not something you need to write — Kitcord registers these listeners automatically from your Kit.

TypeScript
client.on("guildMemberAdd", (member) => {
  // {{member.id}}, {{member.username}}, {{input.guild.id}}
});