Overview

This node operation creates a new document within a specified project (bucket) and vault in Basecamp. It is useful for automating the creation of documents with specific titles and HTML content, optionally setting the document's status to active for immediate publishing. For example, it can be used to programmatically add project documentation or meeting notes to a Basecamp project.

Use Case Examples

1. Creating a project document with a title and HTML content.
2. Publishing a document immediately by setting its status to active.

Properties

Output

JSON

• id - The unique identifier of the created document.
• title - The title of the created document.
• content - The HTML content of the created document.
• status - The status of the created document, e.g., active or draft.
• created_at - Timestamp when the document was created.
• updated_at - Timestamp when the document was last updated.

Dependencies

• Basecamp API authentication via OAuth2

Troubleshooting

• Ensure the Project ID (bucketId) and vaultId are correct and exist in Basecamp to avoid 404 errors.
• Verify that the OAuth2 credentials are valid and have the necessary permissions to create documents.
• If the document content contains HTML, ensure it is properly formatted to avoid API rejection.
• If 'Return Full Response' is enabled, be prepared to handle the full HTTP response object instead of just the document data.

Links

• Basecamp API Documentation - Official API documentation for Basecamp, including endpoints for document creation.