Action: Add Role

Discord Operation

The Add Role action in Discord assigns a specific role (and its permissions) to a user on a server.

Example User Story

I want to give new team members access to our project channels, so I use the Add Role action in Discord to assign them the "Project Contributor" role.

Fields

Field Name	Field Type	Required
guildId	String	Yes
userId	String	Yes
roleId	String	Yes

Related Connections

Discord

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "add-role",
  "state": "inDev",
  "meta": {
    "short": "Add Role",
    "description": "Adds a specified role to a user in a Discord server."
  },
  "input": [
    {
      "name": "guildId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the Discord server (guild)."
      }
    },
    {
      "name": "userId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the user to whom the role will be added."
      }
    },
    {
      "name": "roleId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the role to be added."
      }
    }
  ],
  "output": [
    {
      "name": "success",
      "type": "Boolean",
      "selector": [],
      "meta": {
        "description": "Indicates whether the role was successfully added."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "PUT",
        "path": "/guilds/{{guildId}}/members/{{userId}}/roles/{{roleId}}",
        "headers": {
          "Content-Type": "application/json"
        }
      }
    }
  ]
}