Actions68
- Recordings Actions
- Card Tables Actions
- Forwards Actions
- Events Actions
- Projects Actions
- People Actions
- Chatbots Actions
- Webhooks Actions
- Attachments Actions
- Templates Actions
- Uploads Actions
- Documents Actions
- Lineup Markers Actions
- Subscriptions Actions
- Schedules Actions
- Schedule Entries Actions
Overview
This node operation allows you to create a new upload in a specified bucket and vault within the Basecamp environment. It is useful for automating file uploads, attaching files to projects or messages, and managing digital assets programmatically. For example, you can use this node to upload images, documents, or other files directly from your workflow into a Basecamp project, associating them with specific attachments via SGID references.
Properties
| Name | Meaning |
|---|---|
| Bucket Id | Numeric identifier of the bucket where the upload will be stored. |
| Vault Id | Numeric identifier of the vault within the bucket to organize the upload. |
| Attachable Sgid | A string representing the SGID (Signed Global ID) for an uploaded attachment to link it. |
| Description | Optional HTML-formatted information describing the upload. |
| Base Name | New filename without extension for the uploaded file (e.g., "pizza" for "pizza.png"). |
Output
The node outputs JSON data representing the created upload object as returned by the Basecamp API. This typically includes metadata about the upload such as its ID, URLs, timestamps, and any associated attachment information. The node does not output binary data directly; instead, it manages references to uploaded files.
Dependencies
- Requires an API key credential for authenticating with the Basecamp API.
- The node uses the Basecamp API endpoint constructed dynamically using the Basecamp account ID.
- Proper permissions on the Basecamp account to create uploads in the specified bucket and vault are necessary.
Troubleshooting
- Invalid Bucket or Vault Id: If the provided bucket or vault IDs do not exist or are incorrect, the API will return an error. Verify these IDs in your Basecamp account.
- Missing or Invalid Attachable SGID: The attachable SGID must be valid and correspond to an existing attachment. Errors here indicate invalid or missing SGID values.
- Authentication Errors: Ensure that the API key credential is correctly configured and has sufficient permissions.
- File Naming Issues: Providing an invalid base name (e.g., with forbidden characters) may cause upload failures. Use simple alphanumeric names without extensions.