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
This node integrates with the Basecamp API to create a new To-Do List Group within a specified project and to-do list. It is useful for organizing tasks into groups, allowing users to better structure their task management workflow in Basecamp. For example, a project manager can use this node to programmatically add categorized groups of tasks (like "Design", "Development", or "Testing") under a specific to-do list in a project, facilitating clearer task segmentation and tracking.
Properties
| Name | Meaning |
|---|---|
| Project ID | The numeric ID of the project (bucket) where the to-do list group will be created. |
| todolistId | The numeric ID of the to-do list under which the group will be added. |
| Name | The name/title of the to-do list group to be created. |
| Color | Optional color assigned to the to-do list group for visual identification. |
| Return Full Response | Boolean flag indicating whether to return the full HTTP response (status, headers, body) or just the response body. |
Output
The node outputs JSON data representing the newly created To-Do List Group as returned by the Basecamp API. This typically includes details such as the group's ID, name, color, creation timestamps, and any other metadata provided by the API.
If the "Return Full Response" property is enabled, the output will include the entire HTTP response object, containing status code, headers, and body, instead of only the response body.
Dependencies
- Requires an active connection to the Basecamp API using OAuth2 authentication.
- The user must provide valid credentials with appropriate permissions to create to-do list groups within the specified project.
- The node uses the Basecamp API base URL constructed from the user's account ID.
Troubleshooting
- Invalid Project or To-Do List ID: If the provided project ID or to-do list ID does not exist or the user lacks access, the API will return an error. Verify IDs and permissions.
- Missing Required Fields: The "Project ID", "todolistId", and "Name" fields are mandatory. Omitting these will cause the request to fail.
- API Authentication Errors: Ensure that the OAuth2 credentials are correctly configured and have not expired.
- Color Format Issues: The color property should be a valid color string; invalid formats might be rejected by the API.
- Full Response Handling: When enabling "Return Full Response", downstream nodes must handle the full HTTP response object accordingly.