Basecamp icon

Basecamp

Interact with the Basecamp API

Actions80

Overview

This node operation retrieves todo lists from a specified project bucket and todo set within the Basecamp service. It allows filtering the todo lists by their status, such as active, archived, or trashed. This is useful for project management workflows where you want to programmatically access and process task lists based on their current state.

Practical examples include:

  • Automatically fetching all active todo lists in a project to generate reports.
  • Archiving or cleaning up old todo lists by retrieving those marked as archived or trashed.
  • Integrating with other tools to synchronize task statuses.

Properties

Name Meaning
Bucket Id The numeric ID of the project bucket containing the todo sets.
Todoset Id The numeric ID of the specific todo set within the bucket to retrieve todo lists from.
Status Filter to select todo lists by their status. Options: Active, Archived, Trashed.

Output

The output contains JSON data representing the todo lists retrieved from the specified bucket and todo set. Each item in the output corresponds to a todo list object with its associated properties as returned by the Basecamp API. The structure typically includes identifiers, titles, status, and other metadata relevant to each todo list.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the Basecamp API.
  • The node uses the Basecamp API endpoint constructed dynamically using the authenticated user's Basecamp account ID.
  • Proper configuration of the API credentials and permissions to access the specified buckets and todo sets is necessary.

Troubleshooting

  • Invalid Bucket or Todoset ID: If the provided IDs do not exist or the user lacks permission, the API will return errors. Verify that the IDs are correct and accessible.
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Ensure the API key or OAuth token is correctly configured.
  • Status Filter Issues: Providing an unsupported status value may result in no data or errors. Use only the allowed options: active, archived, trashed.
  • Network or API Downtime: Connectivity issues or Basecamp API outages can cause request failures. Retry after some time or check network settings.

Links and References

Discussion