Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

Overview

The node interacts with Monday.com boards and related entities, specifically enabling the removal of subscribers from a specified board within a workspace and team context. This operation is useful when you want to manage board access by removing certain users or teams who are no longer relevant or should not receive notifications related to that board.

Practical scenarios include:

  • Cleaning up board subscribers after project completion.
  • Removing users or teams who have left an organization or project.
  • Managing notification recipients dynamically based on workflow conditions.

Properties

Name Meaning
Workspace Name or ID Select the workspace containing the board. Can be chosen from a list or specified via expression.
Board Name or ID Select the specific Monday.com board to remove subscribers from. Choose from list or use expression.
Remove Subscribers Names or IDs Select one or more subscribers (users) to remove from the board. Choose from list or specify IDs via expression.
Team Name or ID Select the team associated with the board. Required for this operation. Choose from list or use expression.

Output

The output JSON contains the result of the GraphQL mutation that removes subscribers from the board. It typically includes the id of the affected entity confirming the deletion of subscribers.

Example output structure:

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

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for Monday.com API access.
  • The node makes HTTP POST requests to the Monday.com GraphQL API endpoint (https://api.monday.com/v2).
  • Proper permissions on the API key to modify board subscribers are necessary.
  • n8n environment must have network access to Monday.com API.

Troubleshooting

  • API Key Not Found: The node throws an error if the API key credential is missing or invalid. Ensure the API key is correctly configured in n8n credentials.
  • Board ID Required: If the board ID is not provided, the node will throw an error. Make sure to select or provide a valid board ID.
  • Invalid Subscriber IDs: Providing subscriber IDs that do not exist or are not part of the board may cause errors or no effect. Verify subscriber IDs before removal.
  • Permission Errors: Insufficient permissions on the API key can lead to authorization errors. Confirm the API key has rights to manage board subscribers.
  • Empty Subscriber List: Attempting to remove subscribers without specifying any may result in no action or errors. Always specify at least one subscriber to remove.

Links and References

Discussion