Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

Board → Add Board Subscribers

AI-generated

Overview

The node enables interaction with Monday.com boards, specifically allowing users to add subscribers (both individual users and teams) to a specified board. This operation is useful for automating team collaboration workflows by programmatically managing who has access or notification privileges on a board.

Common scenarios include:

  • Automatically adding new team members as subscribers when a project board is created.
  • Managing board access by adding or updating subscribers based on external triggers or events.
  • Synchronizing subscriber lists between Monday.com and other systems.

Example: When a new project board is created in Monday.com, this node can add the relevant project team and key stakeholders as subscribers to ensure they receive updates and notifications.

Properties

Name Meaning
Workspace Name or ID Select the workspace where the target board resides. You can choose from a list or specify an ID using an expression.
Board Name or ID Select the specific Monday.com board to which subscribers will be added. Choose from the list or specify an ID via expression.
User Subscribers A collection of individual users to add as subscribers. For each user, specify their name or ID and whether they should be added as an owner (with elevated permissions) or a regular subscriber.
Team Subscribers A collection of teams to add as subscribers. For each team, specify the team name or ID and whether they should be added as owners or regular subscribers.

Output

The output JSON contains details about the subscribers added to the board, grouped into four categories:

  • ownerUsers: Information about users added as owners.
  • subscriberUsers: Information about users added as regular subscribers.
  • ownerTeams: Information about teams added as owners.
  • subscriberTeams: Information about teams added as regular subscribers.

Each category includes the response data returned from Monday.com's API mutation calls confirming the addition of subscribers or owners.

Dependencies

  • Requires an API authentication token credential for Monday.com (referred generically as "an API key credential").
  • The node makes HTTP POST requests to the Monday.com GraphQL API endpoint (https://api.monday.com/v2).
  • Proper permissions are required on the API token to manage board subscribers.

Troubleshooting

  • API Key Not Found: If the API key credential is missing or invalid, the node will throw an error. Ensure that a valid API key with appropriate permissions is configured.
  • Board ID Required: The operation requires a valid board ID. If not provided, the node throws an error.
  • Invalid User or Team IDs: If user or team IDs do not exist or are incorrect, the API may return errors or fail silently. Verify IDs before running.
  • Permission Errors: Insufficient permissions on the API token or the board may cause failures when adding subscribers.
  • Empty Subscriber Lists: If no users or teams are specified, no action will be taken; ensure at least one subscriber is provided.

Links and References

This summary focuses exclusively on the "Board" resource and the "Add Board Subscribers" operation as requested.

Discussion