Actions119
- Campfire Actions
- Card Table Actions
- Chatbot Actions
- Client Approval Actions
- Client Correspondence Actions
- Client Reply Actions
- Client Visibility Actions
- Comment Actions
- Document Actions
- Event Actions
- Forward Actions
- Inbox Actions
- Inbox Reply Actions
- Lineup Marker Actions
- Message Actions
- Message Board Actions
- Message Type Actions
- Person Actions
- Project Actions
- Question Actions
- Question Answer Actions
- Questionnaire Actions
- Recording Actions
- Schedule Actions
- Schedule Entry Actions
- Template Actions
- Todo Actions
- Todolist Actions
- Todolist Group Actions
- Todoset Actions
- Upload Actions
- Vault Actions
- Webhook Actions
Overview
This node interacts with the Basecamp API to list To-Do List Groups within a specified project and to-do list. It is useful for users who want to retrieve grouped sets of to-dos organized under specific lists in their Basecamp projects. Typical scenarios include project management automation, reporting on task groups, or syncing to-do group data with other tools.
For example, a user might use this node to fetch all archived or active to-do groups within a particular project bucket and to-do list, enabling them to analyze task progress or generate summaries.
Properties
| Name | Meaning |
|---|---|
| Project ID | The ID of the project (bucket) where the to-do list resides; used in the API endpoint path. |
| To-Do List ID | The ID of the to-do list containing the groups; used in the API endpoint path. |
| Status | Filter to-do list groups by their status. Possible values include "archived" and others as supported by the API. |
| Return All Results | Whether to return all available results or limit the output to a certain number. |
| Return Full Response | Whether to return the full HTTP response including status code and headers, instead of only the response body. |
Output
The node outputs JSON data representing the list of to-do list groups retrieved from the Basecamp API. Each item in the output corresponds to a to-do list group with its associated properties as returned by the API.
If the "Return Full Response" option is enabled, the output includes the entire HTTP response object, which contains status code, headers, and body.
No binary data output is involved in this operation.
Dependencies
- Requires an API authentication token credential configured in n8n to access the Basecamp API.
- The node uses the Basecamp API base URL constructed dynamically using the user's account ID.
- Proper permissions on the Basecamp account are necessary to read project and to-do list group information.
Troubleshooting
Common Issues:
- Invalid or missing Project ID or To-Do List ID will cause the API request to fail.
- Insufficient permissions or expired API credentials may result in authorization errors.
- Filtering by an unsupported status value may return empty results or errors.
Error Messages:
- 401 Unauthorized: Check that the API authentication token is valid and has not expired.
- 404 Not Found: Verify that the provided Project ID and To-Do List ID exist and are accessible.
- 400 Bad Request: Ensure that the status filter value is valid according to the Basecamp API documentation.