Worktables

Overview

The node "Worktables" integrates with Monday.com to perform various operations on boards, items, groups, 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 as well as team subscribers, along with detailed subscriber information such as IDs, names, emails, guest status, verification status, admin rights, creation date, and account details.

This operation is useful when you want to:

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

Practical Example

You might use this node in an automation workflow where, after creating or updating a board, you want to fetch and log all current subscribers to ensure the right people have access or to trigger further actions like sending welcome messages.

Properties

These properties are used 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:

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

  • id: Subscriber's unique identifier.
  • is_guest: Boolean indicating if the subscriber is a guest user.
  • is_pending: Boolean indicating if the subscription is pending.
  • is_verified: Boolean indicating if the subscriber's email/account is verified.
  • account: Object containing account details such as id, logo, and country_code.
  • name: Subscriber's name.
  • email: Subscriber's email address.
  • is_admin: Boolean indicating if the subscriber has admin privileges.
  • enabled: Boolean indicating if the subscriber is enabled.
  • created_at: Timestamp of when the subscriber was added.

• 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 comprehensive output allows downstream nodes or processes to utilize subscriber data effectively.

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 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 stating "API Key not found". Ensure that the API key is correctly configured in n8n credentials.
• Board ID Required: If the board ID is not provided or invalid, the node will fail. Make sure to select or provide a valid board ID.
• Permission Issues: If the API key does not have sufficient permissions to read board subscribers, the request may fail or return incomplete data. Verify the API key's permission scope in Monday.com.
• Network or API Errors: Temporary network issues or Monday.com API downtime can cause errors. Retrying the execution later or checking Monday.com's status page may help.

Links and References

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