Basecamp icon

Basecamp

Interact with Basecamp API

Actions119

Todo → Create a to-Do

AI-generated

Overview

This node operation creates a new to-do item within a specified project (bucket) and to-do list in Basecamp. It is useful for automating task creation in project management workflows, such as adding tasks with specific content, descriptions, assignees, and due dates. For example, it can be used to automatically generate to-dos from form submissions or other triggers.

Use Case Examples

  1. Automatically create a to-do in a project when a new support ticket is received.
  2. Add a task with a due date and assignees when a new feature request is logged.

Properties

Name Meaning
Project ID The ID of the project (bucket) where the to-do will be created. Used in the API endpoint path.
todolistId The ID of the to-do list within the project where the to-do will be created. Used in the API endpoint path.
Content The content or title of the to-do item. This is required and supports HTML editing.
Description Optional description of the to-do item, which may contain HTML.
Assignee IDs IDs of people to assign to this to-do item.
Completion Subscriber IDs IDs of people to notify when this to-do is completed.
Send Notifications Boolean flag indicating whether to notify assignees about being assigned.
Due Date The due date for the to-do item, formatted as a date string (YYYY-MM-DD).
Start Date The date when the to-do item starts.
Return Full Response Boolean flag to return the full API response including status code, headers, and body instead of only the response body.

Output

JSON

  • id - The unique identifier of the created to-do item.
  • content - The content or title of the created to-do.
  • description - The description of the created to-do.
  • assignee_ids - List of IDs assigned to the to-do.
  • completion_subscriber_ids - List of IDs subscribed to completion notifications.
  • notify - Whether notifications were sent to assignees.
  • due_on - The due date of the to-do.
  • starts_on - The start date of the to-do.
  • status - The current status of the to-do (e.g., open, completed).
  • created_at - Timestamp when the to-do was created.

Dependencies

  • Basecamp API with OAuth2 authentication

Troubleshooting

  • Ensure that the Project ID (bucketId) and todolistId are valid and exist in Basecamp, otherwise the API call will fail.
  • The content field is required; leaving it empty will cause an error.
  • If the API returns authentication errors, verify that the OAuth2 credentials are correctly configured and have the necessary permissions.
  • If notifications are not sent as expected, check the 'notify' boolean and the assignee IDs format.
  • Timeout or network errors can occur; adjust the timeout and proxy settings if needed.

Links

Discussion