Worktables

Overview

The node "Worktables" integrates with Monday.com to perform various operations on boards, items, updates, teams, users, and queries. Specifically, for the Board resource and the List Board Subscribers operation, it retrieves all subscribers (users and teams) associated with a specified Monday.com board.

This operation is useful when you want to:

• Get a list of all users subscribed to a particular board.
• Retrieve team subscribers linked to a board.
• Audit or manage board access by viewing current subscribers.

Practical example:
You have a project management board in Monday.com and want to notify or analyze all users and teams subscribed to that board. Using this node operation, you can fetch subscriber details and use them downstream in your workflow for notifications, reporting, or access control.

Properties

Output

The output JSON contains detailed information about the board's subscribers, including both individual users and team subscribers.

The structure includes:

• subscribers: An array of user objects with fields such as:

  • id: User ID
  • is_guest: Whether the user is a guest
  • is_pending: Whether the user subscription is pending
  • is_verified: Verification status
  • account: Object with account details like id, logo, and country_code
  • name: User's name
  • email: User's email address
  • is_admin: Whether the user is an admin
  • enabled: Whether the user is enabled
  • created_at: Timestamp of subscription creation

• team_subscribers: An array of team objects with fields such as:

  • id: Team ID
  • name: Team name
  • users: Array of user objects within the team, each with id, name, and email

This comprehensive output allows workflows to process both individual and team subscribers effectively.

Dependencies

• Requires an API key credential for Monday.com API authentication.
• The node makes HTTP POST requests to the Monday.com GraphQL API endpoint: https://api.monday.com/v2.
• The API key must be configured in n8n credentials for this node to function.
• The workspace and board IDs must be valid and accessible with the provided API key.

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 properly set up in n8n.

• Board ID Required Error:
  The operation requires a valid board ID. If omitted or invalid, the node will throw an error. Verify the board ID input is correct and corresponds to a board in the selected workspace.

• Permission Issues:
  If the API key does not have sufficient permissions to access the board or its subscribers, the request may fail or return incomplete data. Confirm the API key has appropriate access rights.

• Empty Subscriber List:
  If the board has no subscribers, the returned arrays may be empty. This is expected behavior.

Links and References

• Monday.com API Documentation
• Monday.com GraphQL API Reference
• n8n Expressions Documentation (for specifying dynamic inputs)

This summary covers the static analysis of the node's execute method for the Board resource and List Board Subscribers operation, focusing on input properties, output structure, dependencies, and common troubleshooting points.