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 users who no longer need notifications or collaboration rights on that board.

Typical use cases include:

  • Automating the cleanup of board subscribers after project completion.
  • Managing team member roles dynamically based on project phases.
  • Integrating with other workflows to update board subscriber lists automatically.

For example, if a project team changes, you can remove former members from the board subscribers list to prevent them from receiving updates.

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 modify. Can be chosen from a list or specified via expression.
Remove Subscribers Names or IDs Select one or more subscribers (users) to remove from the board. Can be chosen from a list or specified via expression.
Team Name or ID Select the team associated with the operation. Can be chosen from a list or specified via expression.

Output

The output JSON contains the result of the GraphQL mutation that removes subscribers from the board. It typically includes an array of objects with the id of each removed subscriber, confirming successful removal.

Example output structure:

{
  "data": {
    "delete_subscribers_from_board": [
      { "id": "12345" },
      { "id": "67890" }
    ]
  }
}

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 configuration of the API key credential in n8n is necessary for authentication.

Troubleshooting

  • API Key Not Found: If the API key credential is missing or invalid, the node will throw an error. Ensure the API key is correctly configured in n8n credentials.
  • Board ID Required: The operation requires a valid board ID. If not provided, an error will occur.
  • Invalid Subscriber IDs: Removing subscribers requires valid user IDs. Providing incorrect or empty subscriber IDs may cause the mutation to fail or have no effect.
  • Permission Issues: The API key used must have sufficient permissions to modify board subscribers; otherwise, the request will be denied.
  • Empty Removal List: If no subscribers are selected for removal, the mutation might still run but have no effect.

To resolve errors:

  • Verify all required parameters are set.
  • Confirm the API key has appropriate permissions.
  • Check that subscriber IDs exist on the board before attempting removal.

Links and References

Discussion