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

This node interacts with the Basecamp API to retrieve all chatbots associated with a specific project and chat. It is useful for users who want to programmatically access chatbot data within their Basecamp projects, such as listing all chatbots in a particular chat room or campfire.

Practical examples include:

Automating the retrieval of chatbot configurations or statuses for monitoring.
Integrating chatbot data into other workflows or dashboards.
Synchronizing chatbot information with external systems.

Properties

Name	Meaning
Project ID	The ID of the project (bucket) used in the API endpoint path to specify which project to query.
Chat ID	The ID of the chat or campfire within the project, used in the API endpoint path.
Return All Results	Whether to return all available chatbot results or limit the output to a default maximum.
Return Full Response	Whether to return the full HTTP response including status code and headers, or only the body.

Output

The node outputs JSON data representing the list of chatbots retrieved from the specified project and chat. The structure typically includes an array of chatbot objects with their respective properties as defined by the Basecamp API.

If "Return Full Response" is enabled, the output will include the entire HTTP response object containing status code, headers, and body.

No binary data output is indicated for this operation.

Dependencies

Requires an authenticated connection to the Basecamp API using OAuth2 credentials.
The node expects the Basecamp account ID to be configured in the credentials to construct the API base URL.
No additional external dependencies are required beyond the Basecamp API access.

Troubleshooting

Invalid Project ID or Chat ID: If the IDs provided do not exist or the user lacks permission, the API may return errors or empty results. Verify that the IDs are correct and accessible.
Authentication Errors: Ensure that the OAuth2 credentials are valid and have the necessary scopes to access chatbot data.
Pagination Issues: When "Return All Results" is false, only a limited number of chatbots are returned. Enable it to fetch all pages if needed.
API Rate Limits: Excessive requests may lead to rate limiting; handle retries or backoff accordingly.

Common error messages might include unauthorized access, resource not found, or invalid parameters. Checking the full response (if enabled) can help diagnose these issues.

Links and References

Basecamp API Documentation
Basecamp Chatbot API Reference (if available)
n8n documentation on OAuth2 Credentials