Worktables

Interact with Monday.com boards and items

Actions26

Overview

The node interacts with Monday.com boards and their related entities via the Monday.com API. Specifically, for the Board resource and the List Board Activity Logs operation, it retrieves activity logs of a specified board within an optional date range.

This operation is useful for tracking changes, user actions, or events on a Monday.com board over time. For example, you can monitor who made updates, what kind of events occurred (like item creation, status changes), and when these happened. This is beneficial for audit trails, reporting, or triggering workflows based on board activity.

Properties

Name	Meaning
Workspace Name or ID	Select the workspace containing the board. You can choose from a list or specify an ID via expression. Required.
Board Name or ID	Select the specific Monday.com board to retrieve activity logs from. Choose from the list or specify an ID via expression. Required.
From	Optional start date/time to filter activity logs from this date onwards.
To	Optional end date/time to filter activity logs up to this date.

Output

The output JSON contains the raw response from the Monday.com API for the activity logs query. The structure includes:

boards: An array with one board object containing:
- activity_logs: An array of activity log entries, each with fields:
  - id: Unique identifier of the activity log entry.
  - user_id: ID of the user who performed the action.
  - entity: The entity affected by the activity (e.g., item, group).
  - event: The type of event that occurred.
  - data: Additional data related to the event.
  - created_at: Timestamp of when the activity occurred.

No binary data is output by this operation.

Dependencies

Requires an API key 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 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 indicating the API key was not found. Ensure the API key is correctly set in the node's credentials.
Board ID Required: The operation requires a valid board ID. If missing or incorrect, the node will throw an error. Verify the board selection or ID input.
Date Format Issues: The From and To properties expect ISO 8601 date-time strings. Incorrect formats may cause the API to reject the query or return no results.
Empty Results: If no activity logs are returned, check if the date range is correct and if there has been any activity on the board during that period.
API Rate Limits: Excessive requests might hit Monday.com's rate limits, causing errors. Implement retries or reduce request frequency if needed.

Links and References

This summary focuses exclusively on the Board resource and the List Board Activity Logs operation as requested.