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 allowing users to retrieve detailed information about a person within a Basecamp account. This "Get a Person" operation fetches data for a specified person by their unique ID. It is useful in scenarios where you need to access user details such as name, contact info, or role within projects for automation workflows, reporting, or integration with other systems.

For example, you might use this node to:

Automatically pull user details when processing project assignments.
Sync Basecamp user information with an external CRM or HR system.
Retrieve and display person information in custom dashboards or notifications.

Properties

Name	Meaning
Person ID	The unique numeric identifier of the person to retrieve from Basecamp.
Return Full Response	Boolean option to return the entire HTTP response (including status code and headers) instead of just the response body. Useful for debugging or advanced handling.

Output

The node outputs JSON data representing the person object retrieved from the Basecamp API. This typically includes fields such as the person's ID, name, email address, avatar URL, and possibly other metadata related to their Basecamp profile.

If the "Return Full Response" property is enabled, the output will include the full HTTP response structure containing status code, headers, and body, allowing more detailed inspection of the API call result.

No binary data output is involved in this operation.

Dependencies

Requires an active connection to the Basecamp API using OAuth2 authentication.
The node expects the Basecamp account ID to be configured in credentials to construct the correct API base URL.
Internet access to reach the Basecamp API endpoints.

Troubleshooting

Invalid Person ID: If the provided Person ID does not exist or is incorrect, the API will likely return a 404 error. Verify the ID is correct and that the authenticated user has permission to access that person’s data.
Authentication Errors: Missing or expired OAuth tokens will cause authentication failures. Ensure the API credentials are valid and refreshed.
API Rate Limits: Excessive requests may trigger rate limiting by Basecamp. Implement retry logic or reduce request frequency if encountering rate limit errors.
Return Full Response Confusion: Enabling "Return Full Response" changes the output format. If downstream nodes expect only the person data, this may cause issues. Use this option primarily for debugging.