Basecamp icon

Basecamp

Interact with Basecamp API

Actions76

Overview

The "Get a Campfire Line" operation in the Basecamp node retrieves a specific line (message) from a Campfire chat within a Basecamp project. This is useful when you want to fetch detailed information about a particular message in a Campfire chat, such as its content, author, and timestamp.

Common scenarios include:

  • Fetching a single chat message for auditing or logging purposes.
  • Displaying a specific Campfire message in an external dashboard or application.
  • Integrating with other systems that require details of a particular chat line.

For example, if you have a project with ongoing discussions in Campfire chats, you can use this operation to get the exact message by its ID to analyze or process it further.

Properties

Name Meaning
Project ID The ID of the Basecamp project (bucket) where the Campfire chat resides.
chatId The ID of the Campfire chat within the project.
Line ID The ID of the specific Campfire line (message) to retrieve.
Return Full Response Boolean option to return the full HTTP response including status code and headers instead of just the message body.

Output

The output JSON contains the data of the requested Campfire line. This typically includes fields such as the message content, author details, timestamps, and any metadata associated with the line.

If "Return Full Response" is enabled, the output will include the entire HTTP response object, which contains:

  • Status code
  • Headers
  • Body (the Campfire line data)

Otherwise, only the body (the Campfire line data) is returned.

This node does not output binary data.

Dependencies

  • Requires an API authentication token configured in n8n credentials to access the Basecamp API.
  • The node uses the Basecamp API endpoint structured as:
    https://3.basecampapi.com/{accountId}/buckets/{bucketId}/chats/{chatId}/lines/{lineId}.json
  • The user must provide valid IDs for the project, chat, and line to successfully retrieve the data.

Troubleshooting

  • Invalid IDs: If the provided Project ID, chatId, or Line ID do not exist or are incorrect, the API will return an error (e.g., 404 Not Found). Verify the IDs before running the node.
  • Authentication errors: Ensure the API authentication token is valid and has sufficient permissions to access the specified project and Campfire chat.
  • Network issues: Connectivity problems may cause request failures; check network settings and retry.
  • Return Full Response confusion: If enabled, the output structure changes to include status and headers; ensure downstream nodes handle this format correctly.

Links and References

Discussion