Worktables

Overview

The node "Worktables" integrates with Monday.com to interact with various resources such as boards, items, updates, teams, and users. Specifically, for the Board resource and the List Board Subscribers operation, it retrieves all subscribers associated with a specified Monday.com board. This includes individual user subscribers and team subscribers, along with detailed subscriber information.

This operation is useful when you want to:

• Audit or review who has access or is subscribed to a particular board.
• Automate notifications or communications based on board subscribers.
• Synchronize subscriber data with other systems or workflows.

Example use case:
You have a project management board in Monday.com and want to send a summary email to all subscribers whenever a major update occurs. Using this node operation, you can fetch the list of subscribers dynamically and feed that into your email automation workflow.

Properties

These properties are required to identify the exact board within a workspace whose subscribers you want to list.

Output

The output JSON contains detailed information about the board's subscribers, structured as follows:

• subscribers: An array of individual user subscribers with fields including:

  • id: Subscriber's unique identifier.
  • is_guest, is_pending, is_verified: Status flags about the subscriber.
  • account: Object containing account details like id, logo, and country_code.
  • name: Subscriber's name.
  • email: Subscriber's email address.
  • is_admin: Whether the subscriber has admin privileges.
  • enabled: Whether the subscriber is enabled.
  • created_at: Timestamp of subscription creation.

• team_subscribers: An array of team subscribers with fields including:

  • id: Team's unique identifier.
  • name: Team name.
  • users: Array of users within the team, each with id, name, and email.

This rich output allows downstream nodes or processes to utilize subscriber details for further actions.

Dependencies

• Requires an API key credential for Monday.com (referred generically as an API authentication token).
• 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 read board subscriber information are necessary.
• n8n environment must be configured with this API key credential under the node's credentials.

Troubleshooting

• API Key Not Found Error:
  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 and linked to the node.

• Board ID Required Error:
  If the board ID property is empty or invalid, the node will fail. Make sure to select or provide a valid board ID.

• Permission Denied or Access Errors:
  If the API key lacks permission to access the board or its subscribers, the request will fail. Verify the API key's scopes and user permissions in Monday.com.

• Empty Subscriber List:
  If the board has no subscribers, the output arrays will be empty. Confirm the board actually has subscribers before assuming an error.

Links and References

• Monday.com API Documentation
• n8n Expressions Documentation
• Monday.com GraphQL API Reference

This summary covers the static analysis of the "List Board Subscribers" operation for the Board resource in the Worktables node, focusing on input properties, output structure, dependencies, and common troubleshooting points.