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 integrates with the Basecamp API to retrieve to-do lists within a specified project and to-do set. It is useful for automating workflows that involve managing tasks in Basecamp, such as syncing task data with other tools, generating reports on project progress, or triggering actions based on task statuses.
For example, you can use this node to fetch all archived or active to-do lists from a particular project bucket and to-do set, then process or analyze these lists downstream in your workflow.
Properties
| Name | Meaning |
|---|---|
| Project ID | The numeric ID of the project (bucket) containing the to-do sets. Used in the API path. |
| To-Do Set ID | The numeric ID of the to-do set within the project. Used in the API path. |
| Status | Filter to-do lists by their status. Possible values include "archived" and others. |
| Return All Results | Boolean flag indicating whether to return all available results or limit to a subset. |
| Return Full Response | Boolean flag to return the full HTTP response (status code, headers, body) instead of just the body. |
Output
The node outputs JSON data representing the retrieved to-do lists. Each item in the output corresponds to a to-do list object as returned by the Basecamp API, including details such as list name, status, and associated metadata.
If "Return Full Response" is enabled, the output includes the entire HTTP response object, which contains status codes and headers alongside the body.
The node does not output binary data.
Dependencies
- Requires an authenticated connection to the Basecamp API using OAuth2 credentials.
- The node expects the Basecamp account ID to be configured in the credentials to construct the API base URL.
- No additional external dependencies are required beyond the Basecamp API access.
Troubleshooting
- Invalid Project or To-Do Set ID: If the provided IDs do not exist or the user lacks permission, the API will return errors. Verify the IDs and ensure proper access rights.
- Status Filter Issues: Using an unsupported status value may result in empty responses or errors. Confirm valid status options with Basecamp API documentation.
- Pagination Handling: When "Return All Results" is enabled, the node handles pagination via HTTP Link headers. If pagination fails, check network connectivity and API rate limits.
- Authentication Errors: Ensure the OAuth2 credentials are valid and have not expired. Re-authenticate if necessary.
- Full Response Option: Enabling "Return Full Response" changes the output format; downstream nodes must handle this accordingly.