Workspace icon

Workspace

Get and change data from Workspace API

Overview

The "Update User" operation in the Workspace node allows you to modify existing user information within the Workspace system. This is useful for keeping user records up-to-date, such as changing a user's name, email, company affiliation, department, or their Microsoft Entra ID (formerly Azure AD). Practical scenarios include updating contact details after a user changes departments, correcting typos in user data, or linking a user to a new identity provider ID.

Properties

Name Meaning
User ID Unique identifier of the user to update.
First Name New first name for the user.
Last Name New last name for the user.
Email New email address for the user.
Company New company name for the user.
Department New department for the user.
Entra ID New Microsoft Entra ID (formerly Azure AD) for the user.

Output

The node outputs JSON data representing the updated user object as returned by the Workspace API. This typically includes the user's updated fields reflecting the changes made. The output does not include binary data.

Dependencies

  • Requires an active connection to the Workspace API.
  • Needs an API key credential and tenant information configured in n8n credentials.
  • The base URL for the Workspace API must be set in the node's credentials configuration.

Troubleshooting

  • Missing User ID: If the User ID is not provided or incorrect, the update will fail because the API cannot identify which user to update.
  • Invalid Field Values: Providing invalid formats (e.g., malformed email) may cause the API to reject the request.
  • Authentication Errors: Ensure that the API key and tenant credentials are correctly configured; otherwise, authentication errors will occur.
  • API Endpoint Issues: Verify that the base URL is correct and the Workspace API service is reachable.

Links and References

Discussion