Monday.com icon

Monday.com

Interact with Monday.com API
Join our community

Actions26

Overview

This node interacts with the Monday.com API to retrieve detailed information about a specific user. It allows fetching a user by their unique ID and optionally includes various additional fields such as email, account details, admin or guest status, profile photo URL, team memberships, and creation date. This operation is useful in scenarios where you need to enrich workflows with user-specific data from Monday.com, for example, to personalize notifications, audit user activity, or integrate user details into other systems.

Properties

Name Meaning
User ID The unique identifier of the user to retrieve.
Return Fields A collection of optional boolean flags specifying which additional user fields to include:
- Include Email: Whether to include the user's email address.
- Include Account: Whether to include account-related information.
- Include Admin Status: Whether to include if the user has admin privileges.
- Include Guest Status: Whether to include if the user is a guest.
- Include Photo: Whether to include the URL of the user's profile photo.
- Include Teams: Whether to include the teams the user belongs to.
- Include Created At: Whether to include the user's creation date.

Output

The output is a JSON object representing the user data retrieved from Monday.com. It contains the user's core information along with any additional fields requested via the "Return Fields" options. If the user is not found, an error is thrown indicating that the user with the specified ID does not exist.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "id": "12345678",
  "name": "John Doe",
  "email": "john.doe@example.com",               // included if selected
  "account": { /* account info */ },             // included if selected
  "isAdmin": true,                               // included if selected
  "isGuest": false,                              // included if selected
  "photoUrl": "https://...",                      // included if selected
  "teams": [/* array of team memberships */],   // included if selected
  "createdAt": "2023-01-01T12:00:00Z"            // included if selected
}

Dependencies

  • Requires an active connection to the Monday.com API using an API token credential.
  • The node uses the Monday.com API client internally to perform queries.
  • No additional external dependencies are required beyond the configured Monday.com API credentials.

Troubleshooting

  • User Not Found Error: If the specified User ID does not exist, the node throws an error stating "User with ID {userId} not found". Verify that the User ID is correct and exists in your Monday.com account.
  • API Authentication Issues: Ensure that the provided API token credential is valid and has sufficient permissions to access user data.
  • Network or Rate Limiting Errors: Network issues or hitting Monday.com's API rate limits may cause errors. Retry after some time or check your API usage.
  • Invalid Input Format: Make sure the User ID is provided as a string and all boolean options in "Return Fields" are correctly set.

Links and References

Discussion