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 integrates with the Basecamp API to retrieve project data. Specifically, the "Get Projects" operation under the "Project" resource fetches a list of projects filtered by their status (e.g., active). This node is useful for workflows that need to synchronize or analyze project information from Basecamp, such as generating reports, triggering actions based on project states, or integrating project data into other systems.

Practical examples include:

Automatically listing all active projects to create dashboards.
Fetching archived projects for audit purposes.
Using project data to trigger notifications or updates in other tools.

Properties

Name	Meaning
Status	Filter projects by their status. Options include: `"active"` (default) and potentially others depending on API support.
Return All Results	Boolean flag indicating whether to return all matching projects (`true`) or limit results (`false`).
Return Full Response	Boolean flag indicating whether to return the full HTTP response (status code, headers, body) instead of only the response body.

Output

The node outputs JSON data representing the list of projects retrieved from Basecamp. The structure typically includes an array of project objects, each containing details such as project ID, name, status, and other metadata as provided by the Basecamp API.

If the "Return Full Response" property is enabled, the output will include the entire HTTP response object, including status code and headers, allowing for more detailed handling or debugging.

No binary data output is involved in this operation.

Dependencies

Requires an API authentication token configured via OAuth2 credentials to access the Basecamp API.
The node uses the Basecamp API base URL constructed dynamically using the account ID from credentials.
No additional external dependencies are required beyond proper API credentials and network access.

Troubleshooting

Common Issues:
- Invalid or expired API credentials will cause authentication failures.
- Incorrect account ID configuration may lead to failed requests or 404 errors.
- Filtering by unsupported status values may result in empty responses or errors.
Error Messages:
- Authentication errors typically indicate issues with the API key or OAuth token; re-authenticate or update credentials.
- HTTP 404 or 400 errors suggest incorrect endpoint usage or invalid parameters; verify the "Status" filter and account ID.
- Pagination-related errors can occur if "Return All Results" is enabled but the API limits are exceeded; consider disabling this option or handling pagination carefully.