Basecamp icon

Basecamp

Interact with Basecamp API

Actions76

Overview

This node integrates with the Basecamp API to create a new column within a specified card table in a project (referred to as a "bucket" in Basecamp). It is useful for users who want to programmatically organize and manage their project workflows by adding columns to card tables, which can represent different stages or categories of tasks or items.

Practical examples include:

  • Automatically adding a new status column like "In Review" or "Blocked" to a project’s card table when certain conditions are met.
  • Creating custom columns to categorize cards dynamically based on external triggers or data inputs.

Properties

Name Meaning
Project ID The numeric ID of the project (bucket) where the card table exists. Used in the API path.
cardTableId The numeric ID of the card table to which the new column will be added. Used in the API path.
Title The title/name of the new column to create in the card table.
Description Optional description text for the new column.
Return Full Response Boolean flag indicating whether to return the full HTTP response (status code, headers, body) or just the response body.

Output

The node outputs JSON data representing the newly created column object returned from the Basecamp API. This typically includes details such as the column's ID, title, description, position, and other metadata.

If the "Return Full Response" property is set to true, the output will include the entire HTTP response including status code and headers, not just the body.

The node does not output binary data.

Dependencies

  • Requires an active Basecamp account with appropriate permissions.
  • Needs an API authentication token configured in n8n credentials to authorize requests to the Basecamp API.
  • The base URL for API requests is constructed using the user's Basecamp account ID.

Troubleshooting

  • Invalid Project or Card Table ID: If the provided project or card table 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", "cardTableId", and "Title" fields are mandatory. Omitting these will cause the request to fail.
  • Authentication Errors: Ensure that the API key or OAuth token is valid and has sufficient scopes to create columns.
  • API Rate Limits: Excessive requests may trigger rate limiting; handle retries accordingly.
  • Unexpected Response Structure: If "Return Full Response" is enabled, downstream nodes must handle the full HTTP response format.

Links and References

Discussion