Actions29
- Board Actions
- Item Actions
- Update Actions
- Team Actions
- User Actions
- Query Actions
Overview
The node interacts with Monday.com boards and their subscribers, specifically allowing you to add subscribers (users or teams) to a specified board within a workspace. This operation is useful for automating team collaboration setups, ensuring the right users and teams have access and notifications on relevant project boards.
Common scenarios include:
- Automatically adding new team members as subscribers to project boards.
- Managing board access by programmatically assigning owners and subscribers.
- Integrating with HR or onboarding workflows to keep boards updated with correct subscribers.
Example: When a new project board is created, this node can add specific users as owners and other users or teams as subscribers to ensure they receive updates and have appropriate permissions.
Properties
| Name | Meaning |
|---|---|
| Workspace Name or ID | Select the workspace where the board exists. You can choose from a list or specify an ID using an expression. |
| Board Name or ID | Select the target Monday.com board to which subscribers will be added. Choose from the list or specify an ID via expression. |
| User Subscribers | A collection of users to add as subscribers. For each user, specify the user name or ID and whether they should be added as an owner (true) or subscriber (false). |
| 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 an owner (true) or subscriber (false). |
Output
The output JSON contains details about the subscription actions performed:
ownerUsers: The response data for users added as owners.subscriberUsers: The response data for users added as subscribers.ownerTeams: The response data for teams added as owners.subscriberTeams: The response data for teams added as subscribers.boardId: The ID of the board to which subscribers were added.
Each field includes the IDs and names of the entities successfully added.
Dependencies
- Requires an API key credential for Monday.com API access.
- The node makes HTTP POST requests to the Monday.com GraphQL API endpoint at
https://api.monday.com/v2. - Proper configuration of the API key in n8n credentials is necessary.
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 set up in n8n credentials.
- 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 are incorrect or do not exist, the mutation may fail or partially succeed. Verify IDs before running.
- Permission Issues: The API key must have sufficient permissions to modify board subscribers; otherwise, mutations will fail.
- Empty Subscriber Lists: If no users or teams are specified, no action will be taken. Make sure to provide at least one subscriber.
Links and References
- Monday.com API Documentation
- n8n Expressions Documentation
- Monday.com Board Subscribers Mutation (general reference)
This summary covers the "Add Board Subscribers" operation under the "Board" resource, detailing its inputs, outputs, dependencies, and common troubleshooting points based on static analysis of the provided source code and property definitions.