Worktables icon

Worktables

Interact with Monday.com boards and items

Actions29

Overview

The node interacts with Monday.com boards and their subscribers, specifically supporting the operation to remove subscribers from a board. This operation allows users to manage who is subscribed to a particular board by removing specified users or teams from the subscriber list.

Common scenarios where this node is beneficial include:

  • Automating the cleanup of board subscribers when team members leave a project.
  • Managing access control dynamically by removing subscribers based on workflow conditions.
  • Integrating with other systems to synchronize user permissions on Monday.com boards.

For example, you could use this node in an automation that removes users from a board once their task is completed or if they are no longer part of a project team.

Properties

Name Meaning
Workspace Name or ID Select the workspace containing the board. Choose from a dropdown or specify an ID via expression.
Board Name or ID Select the specific Monday.com board from which subscribers will be removed. Choose from a dropdown or specify an ID.
Remove Subscribers Names or IDs Select one or more subscribers (users) to remove from the board. Choose from a list or specify IDs using expressions.
Team Subscribers (teamBoardIds) Optionally specify teams with ownership or subscription status to remove as subscribers from the board.
Team Subscribers (teamIds) Alternative way to specify multiple teams by selecting from a list or specifying IDs for removal as subscribers.
Team Name or ID Select a single team to remove as a subscriber from the board.

Note: The properties related to teams allow specifying whether the team is an owner or just a subscriber, affecting how the removal is processed.

Output

The output JSON contains the result of the GraphQL mutation that removes subscribers from the board. Specifically, it returns an object with the id of the removed subscribers confirming successful removal.

Example output structure:

{
  "delete_subscribers_from_board": [
    {
      "id": "123456"
    }
  ]
}

This confirms which subscribers were successfully removed from the board.

Dependencies

  • Requires an API key credential for Monday.com API authentication.
  • The node makes HTTP POST requests to the Monday.com GraphQL API endpoint (https://api.monday.com/v2).
  • Proper configuration of the API key credential in n8n is necessary for authorization.

Troubleshooting

  • API Key Not Found: If the API key credential is missing or invalid, the node will throw an error indicating the API key was not found. Ensure the credential is correctly set up.
  • Board ID Required: The operation requires a valid board ID. Omitting this will cause an error.
  • Invalid Subscriber IDs: Providing subscriber IDs that do not exist or are not currently subscribed may result in errors or no changes.
  • Permission Issues: The API key used must have sufficient permissions to modify board subscribers; otherwise, mutations will fail.
  • Empty Subscriber List: Attempting to remove subscribers without specifying any will likely result in no action or an error.

To resolve these issues:

  • Verify API credentials and permissions.
  • Confirm that board and subscriber IDs are correct and current.
  • Use the node's dropdowns or load options to select valid entities.

Links and References

This summary focuses on the "Remove Board Subscribers" operation within the "Board" resource of the provided node implementation.

Discussion