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
The "Get to-Dos" operation of the Todo resource in this Basecamp node retrieves a list of to-do items from a specified project and to-do list. This operation is useful for workflows that need to fetch tasks for tracking progress, reporting, or further automation such as notifications or task updates.
Typical use cases include:
- Fetching all to-dos in a project’s specific to-do list to display or process them.
- Filtering to-dos by their completion status to focus on pending or completed tasks.
- Paginating through large sets of to-dos when there are many items.
For example, you might use this node to get all incomplete to-dos from a marketing campaign project to generate a daily report of outstanding tasks.
Properties
| Name | Meaning |
|---|---|
| Project ID | The numeric ID of the project (bucket) from which to retrieve to-dos. Used in the API path. |
| To-Do List ID | The numeric ID of the to-do list within the project. Used in the API path. |
| Show Completed | Filter to-dos by completion status. Options: "true" to include completed, "false" to exclude them. |
| Page Number | The page number for paginated results, allowing retrieval of subsequent pages of to-dos. |
| Return All Results | Boolean flag indicating whether to return all to-dos across all pages (true) or just one page (false). |
| Return Full Response | Boolean flag to return the full HTTP response including status code and headers instead of only the body. |
Output
The output JSON contains an array of to-do objects retrieved from the specified project and to-do list. Each to-do item typically includes details such as its ID, content, completion status, due date, assignees, and other metadata as provided by the Basecamp API.
If the "Return Full Response" option is enabled, the output will include the entire HTTP response object with status code, headers, and body.
This 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 beyond the Basecamp API and proper authentication.
Troubleshooting
- Invalid Project or To-Do List ID: If the IDs provided do not exist or the user lacks access, the API will return an error. Verify the IDs and permissions.
- Pagination Issues: When retrieving many to-dos, ensure "Return All Results" is set to true to paginate through all pages; otherwise, only the first page is returned.
- API Rate Limits: Excessive requests may hit Basecamp API rate limits causing errors. Implement retry logic or reduce request frequency.
- Authentication Errors: Ensure the OAuth2 credentials are valid and have not expired.
- Incorrect Completion Filter: The "Show Completed" property expects string values
"true"or"false". Using other values may cause unexpected filtering.