Basecamp

Interact with Basecamp API

Actions76

Campfire Actions
- Create a Campfire Line
- Delete a Campfire Line
- Get a Campfire
- Get a Campfire Line
- Get Campfire Lines
- Get Campfires
Card Table Actions
- Create a Card
- Create a Column
- Get a Card
- Get a Card Table
- Get a Column
- Get Cards in a Column
- Move a Card
- Move a Column
- Update a Card
- Update a Column
Chatbot Actions
- Create a Chatbot
- Create a Chatbot Line
- Delete a Chatbot
- Get a Chatbot
- Get All Chatbots
- Update a Chatbot
Client Approval Actions
- Get a Client Approval
- Get Client Approvals
Client Correspondence Actions
- Get a Client Correspondence
- Get Client Correspondences
Client Reply Actions
- Get Client Replies
- Get a Client Reply
Client Visibility Actions
- Toggle Client Visibility
Comment Actions
- Get Comments
- Create a Comment
- Get a Comment
- Update a Comment
Document Actions
- Get Documents
- Create a Document
- Get a Document
- Update a Document
Event Actions
- Get Events
Forward Actions
- Get Forwards
- Get a Forward
Inbox Actions
- Get Inbox
Inbox Reply Actions
- Get Inbox Replies
- Get an Inbox Reply
Lineup Marker Actions
- Create a Marker
- Update a Marker
- Delete a Marker
Message Actions
- Get Messages
- Create a Message
- Get a Message
- Update a Message
Message Board Actions
- Get Message Board
Message Type Actions
- Create a Message Type
- Destroy a Message Type
- Get a Message Type
- Get Message Types
- Update a Message Type
Person Actions
- Get a Person
- Get My Profile
- Get People
- Get People on a Project
- Manage People on a Project
Project Actions
- Create a Project
- Get a Project
- Get Projects
- Trash a Project
- Update a Project
Question Actions
- Get Questions
- Create a Question
- Get a Question
- Update a Question
Question Answer Actions
- Get Question Answers
- Get a Question Answer
Questionnaire Actions
- Get Questionnaire
Recording Actions
- Get Recordings
- Trash a Recording
- Archive a Recording

Overview

The node interacts with the Basecamp API, specifically providing operations related to various Basecamp resources. For the Chatbot resource with the Get a Chatbot operation, it retrieves detailed information about a specific chatbot integration within a given project and chat (campfire). This is useful when you want to programmatically access chatbot configurations or status in your Basecamp projects.

Common scenarios:

Fetching chatbot details to display or log chatbot settings.
Integrating chatbot data into other workflows or dashboards.
Automating monitoring or management of chatbot integrations across projects.

Example:
You have multiple chatbots integrated into different project chats in Basecamp. Using this node, you can retrieve each chatbot’s configuration by specifying the project ID, chat ID, and chatbot integration ID, then use that data downstream for reporting or automation.

Properties

Name	Meaning
Project ID	The numeric ID of the Basecamp project (bucket) where the chatbot resides.
chatId	The numeric ID of the chat/campfire within the project where the chatbot is integrated.
Integration ID	The numeric ID of the chatbot/integration to retrieve details for.
Return Full Response	Boolean flag indicating whether to return the full HTTP response (status code, headers, body) or just the response body.

Output

The output JSON contains the chatbot details as returned by the Basecamp API for the specified project, chat, and integration IDs.
If Return Full Response is set to false (default), the output will be the parsed JSON body containing chatbot information.
If Return Full Response is true, the output includes the entire HTTP response object, which contains:
- Status code
- Headers
- Body (chatbot details)

No binary data output is involved in this operation.

Dependencies

Requires an active connection to the Basecamp API via OAuth2 authentication.
The node expects the user to provide valid credentials with appropriate permissions to access the specified project, chat, and chatbot integration.
The base URL for API requests is constructed dynamically using the authenticated account ID.

Troubleshooting

Invalid IDs: If the provided Project ID, chat ID, or Integration ID do not exist or are incorrect, the API will likely return a 404 Not Found error. Verify the IDs before running the node.
Authentication errors: Missing or invalid API credentials will cause authentication failures. Ensure the OAuth2 credentials are correctly configured and authorized.
Permission issues: Even with valid credentials, insufficient permissions on the Basecamp account may result in authorization errors.
Return Full Response confusion: If users enable "Return Full Response" but do not handle the full response structure downstream, they might encounter unexpected data formats. Make sure to process the output accordingly.

Links and References

Basecamp API Documentation
Basecamp Chatbot Integration Guide (for understanding chatbot objects and endpoints)