Update User

Update an existing Slack user by overwriting values for specified attributes.

Required fields are indicated in red.

Unless otherwise mentioned, all fields are text.


Set Empty Field (drop-down): choose from YES and NO

  • YES: input fields that are not selected will remain unchanged; input fields that are selected but left blank or filled in with a null value will clear the existing value in those fields

  • NO: input fields that are not selected, or selected but left blank or set to a null value, will be removed from the final request, so that these fields will remain unchanged after the update request


  • The following attributes can't be set to empty:

    • Primary Email

    • Secondary Email

    • Username

    • Nickname

  • The Primary Phone and Mobile Phone attributes can only be removed when together selected, and left blank or filled in with a null value.

  • The Address attribute will only be removed when all its sub-attributes are select, and left blank or filled in with a null value.

  • Sub-attributes can't be removed separately.


Update by

  • ID: user's unique identification


  • Primary Email: user’s primary email address

  • Secondary Name: user’s secondary email address


  • Username: login username of the user

  • Nickname: user’s nickname

  • Last Name: user’s last name

  • First Name: user’s first name

  • Display Name: name of the user, suitable for display to end users

  • Honorific Prefix: user’s honorific prefix or title


  • Primary Phone: user’s primary phone number

  • Mobile Phone: user’s mobile phone number


  • Street Address: full street address of the user

  • Locality: locality of the user

  • Region: region of the user

  • Postal Code: zip or postal code of the user

  • Country: country of the user

User Details

  • Profile Photo URL: URL for the user’s profile photo

  • What I Do: informal profile description of the user’s role

  • User Type: type of user

  • Role: user’s role in their organization


  • Time Zone )(drop-down)_: user’s time zone

  • Preferred Language: user’s preferred language

  • Locale: user's default location for purposes of localizing items like currency, date/time format, and numerical representations


  • Department: name of user’s department

  • Division: name of user’s division

  • Employee Number: user’s organization- or company-assigned unique identifier

  • Organization: name of user’s organization

  • Cost Center: name of the cost center assigned with the user

  • Manager ID: unique identifier of the user’s manager



  • ID: user's unique identification