Actions80
- Todos Actions
- Card Tables Actions
- Forwards Actions
- Events Actions
- Recordings Actions
- Projects Actions
- People Actions
- Chatbots Actions
- Webhooks Actions
- Attachments Actions
- Templates Actions
- Uploads Actions
- Documents Actions
- Lineup Markers Actions
- Subscriptions Actions
- Schedules Actions
- Schedule Entries Actions
- Todo Sets Actions
- Todo Lists Actions
Overview
This node interacts with the Basecamp API to retrieve todos from a specified project bucket and todo list. It is useful for automating task management workflows, such as fetching active or completed tasks for reporting, synchronization with other tools, or triggering further automation based on todo status.
For example, you can use this node to:
- Get all active todos in a specific todo list to display in a dashboard.
- Retrieve archived todos for audit or historical analysis.
- Filter todos by completion status to trigger notifications or follow-up actions.
Properties
| Name | Meaning |
|---|---|
| Bucket Id | The numeric ID of the project bucket containing the todo list. |
| Todolist Id | The numeric ID of the todo list from which to fetch todos. |
| Status | Filter todos by their status. Options: Active, Archived, Trashed. |
| Completed | Boolean filter to specify whether to get completed (true) or not completed (false) todos. |
Output
The node outputs JSON data representing the list of todos retrieved from the specified bucket and todo list. Each todo item typically includes details such as its title, status, completion state, due dates, and other metadata provided by the Basecamp API.
If the node supports binary data output (not indicated here), it would represent attachments or files related to todos, but this node primarily deals with JSON todo objects.
Dependencies
- Requires an API key credential for authenticating with the Basecamp API.
- Needs the Basecamp account ID to construct the base URL for API requests.
- The node uses the Basecamp REST API endpoint
https://3.basecampapi.com/{basecampId}.
Troubleshooting
- Invalid Bucket or Todolist ID: If the IDs are incorrect or do not exist, the API will return errors or empty results. Verify the IDs in your Basecamp account.
- Authentication Errors: Ensure the API key or OAuth token is valid and has sufficient permissions.
- Status or Completed Filters Not Working: Confirm that the filter values match allowed options; otherwise, the API may ignore them or return unexpected results.
- Network Issues: Check connectivity to the Basecamp API endpoint.
Common error messages might include unauthorized access, resource not found, or bad request due to invalid parameters. Resolving these usually involves checking credentials, verifying input IDs, and ensuring correct parameter usage.