Basecamp icon

Basecamp

Interact with Basecamp API

Actions119

Todolist → Create a to-Do List

AI-generated

Overview

This node operation creates a new to-do list within a specified project (bucket) and to-do set in Basecamp. It is useful for organizing tasks by creating distinct to-do lists under projects and sets, allowing users to manage and track tasks efficiently. For example, a project manager can create a to-do list for a specific phase of a project to assign and monitor tasks.

Use Case Examples

  1. Create a to-do list named 'Sprint Planning' in project ID 123 and to-do set ID 456 to organize tasks for the sprint.
  2. Add a new to-do list with a description containing HTML formatting to provide detailed instructions for team members.

Properties

Name Meaning
Project ID The ID of the project (bucket) used in the API endpoint path to specify where the to-do list will be created.
todosetId The ID of the to-do set used in the API endpoint path to specify the set under which the to-do list will be created.
Name The name of the to-do list to be created.
Description Optional description of the to-do list, which may contain HTML content to provide additional details.
Return Full Response Whether to return the full API response including status code, headers, and body instead of only the response body.
Request Options Additional request options such as batching, SSL certificate validation, proxy settings, and timeout configuration to customize the API request behavior.

Output

JSON

  • id - The unique identifier of the created to-do list.
  • name - The name of the created to-do list.
  • description - The description of the created to-do list, if provided.
  • created_at - Timestamp when the to-do list was created.
  • updated_at - Timestamp when the to-do list was last updated.

Dependencies

  • Basecamp API
  • An OAuth2 API key credential for authentication

Troubleshooting

  • Ensure that the Project ID (bucketId) and todosetId are valid and exist in Basecamp to avoid 404 errors.
  • If the API returns authentication errors, verify that the OAuth2 credentials are correctly configured and have the necessary permissions.
  • Timeout errors may occur if the server is slow to respond; consider increasing the timeout setting in Request Options.
  • If SSL certificate validation fails and you trust the endpoint, enable 'Ignore SSL Issues (Insecure)' to bypass SSL errors.

Links

Discussion