Basecamp icon

Basecamp

Interact with Basecamp API

Actions119

Upload → Create an Upload

AI-generated

Overview

This node operation allows users to create an upload within a specified project (bucket) and vault in Basecamp. It is useful for attaching files or documents to a project by providing the attachment's SGID, along with optional metadata such as a description and a new base filename. This operation is beneficial in scenarios where users need to programmatically manage file uploads to Basecamp projects, for example, automating document uploads or integrating file attachments from other systems.

Use Case Examples

  1. Uploading a project report file to a specific Basecamp project and vault by providing the attachment SGID and optional description.
  2. Automating the upload of images or documents to a Basecamp project with a custom base filename for better organization.

Properties

Name Meaning
Project ID The ID of the project (bucket) where the upload will be created. Used in the API endpoint path.
Vault ID The ID of the vault within the project where the upload will be stored. Used in the API endpoint path.
Attachment SGID The SGID for the attachment to upload, obtained from the Create an attachment endpoint. This identifies the file to be uploaded.
Description Optional description of the upload, which may contain HTML content.
Base Filename Optional new base filename for the upload, without the file extension.
Return Full Response Whether 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 upload.
  • attachable_sgid - The SGID of the attachment associated with the upload.
  • description - The description provided for the upload.
  • base_name - The base filename of the upload without extension.
  • created_at - Timestamp when the upload was created.
  • updated_at - Timestamp when the upload was last updated.

Dependencies

  • Basecamp API with OAuth2 authentication

Troubleshooting

  • Ensure that the Project ID and Vault ID are correct and exist in Basecamp to avoid 404 errors.
  • Verify that the Attachment SGID is valid and obtained from a prior attachment creation step.
  • If the API returns authentication errors, check that the OAuth2 credentials are correctly configured and have the necessary permissions.
  • Timeout errors can occur if the server is slow to respond; consider increasing the timeout setting in request options.
  • If SSL certificate validation fails, enabling the 'Ignore SSL Issues' option may help, but use with caution.

Links

Discussion