discord / trigger / schema v1
Discord: Member
Trigger when a member joins, leaves, or receives a role
Prerequisites
- Add the discord plugin inside this workflow.
- Connect and authorize a discord account before running this node.
Parameters
| Parameter | Type | Description |
|---|---|---|
ServerguildId | discord_guild Required | The Discord server this trigger watches. Your bot must be a member of it. |
Role FilterroleFilter | discord_role Optional | Optional, only for the "Role Assigned" output. Empty = fires for ANY role being assigned; pick roles to only react to those. |
Ignore BotsignoreBots | boolean Optional | Skips bot accounts joining or leaving, so your welcome messages only greet real people. |
Inputs and outputs
Inputs
No ports declared.
Outputs
on_member_join- Member Joined (output)on_member_leave- Member Left (output)on_role_assigned- Role Assigned (output)user_id- User ID (output)username- Username (output)display_name- Display Name (output)avatar- Avatar URL (output)is_bot- Is Bot (output)guild_id- Server ID (output)guild_name- Server Name (output)role_id- Role ID (output)role_name- Role Name (output)roles- Member role IDs (output)joined_at- Joined At (output)timestamp- Timestamp (output)
Output data schema
[
{
"key": "user_id",
"type": "user",
"label": "User ID",
"bindingRole": "event_subject"
},
{
"key": "username",
"type": "string",
"label": "Username",
"bindingRole": "event_subject"
},
{
"key": "display_name",
"type": "string",
"label": "Display Name",
"description": "Server nickname if set, otherwise the username",
"bindingRole": "event_subject"
},
{
"key": "avatar",
"type": "url",
"label": "Avatar URL",
"bindingRole": "event_subject"
},
{
"key": "is_bot",
"type": "boolean",
"label": "Is Bot",
"bindingRole": "event_subject"
},
{
"key": "guild_id",
"type": "guild",
"label": "Server ID",
"bindingRole": "current_context"
},
{
"key": "guild_name",
"type": "string",
"label": "Server Name",
"bindingRole": "current_context"
},
{
"key": "role_id",
"type": "role",
"label": "Role ID",
"description": "Role Assigned branch only.",
"bindingRole": "event_subject"
},
{
"key": "role_name",
"type": "string",
"label": "Role Name",
"description": "Role Assigned branch only.",
"bindingRole": "event_subject"
},
{
"key": "roles",
"type": "array",
"label": "Member role IDs",
"description": "All roles the member has at the time of the event",
"items": {
"key": "role_id",
"type": "snowflake",
"bindingRole": "event_subject"
},
"bindingRole": "event_subject"
},
{
"key": "joined_at",
"type": "timestamp",
"label": "Joined At"
},
{
"key": "timestamp",
"type": "timestamp",
"label": "Timestamp"
}
]Examples and troubleshooting have not yet been reviewed for this contract.
Version and compatibility
This reference follows the current authoring contract. Existing workflows retain their saved node revisions.
Contract identifier
0649ec283fc3c2ad826a9dc9cf50979d9b8788a026a619cef560541ff110bd52