Actions76
- Campfire Actions
- Card Table Actions
- Chatbot Actions
- Client Approval Actions
- Client Correspondence Actions
- Client Reply Actions
- Client Visibility Actions
- Comment Actions
- Document Actions
- Event Actions
- Forward Actions
- Inbox Actions
- Inbox Reply Actions
- Lineup Marker Actions
- Message Actions
- Message Board Actions
- Message Type Actions
- Person Actions
- Project Actions
- Question Actions
- Question Answer Actions
- Questionnaire Actions
- Recording Actions
Overview
This node interacts with the Basecamp API to manage people associated with a specific project. It allows users to grant access to new people, revoke access from existing people, and create new people within the context of a project. This is useful for automating team management tasks in project collaboration environments, such as adding or removing team members programmatically based on workflow triggers.
Practical examples include:
- Automatically granting access to new hires or contractors when they join a project.
- Revoking access from people who are no longer part of the project.
- Creating new user entries in bulk and assigning them to projects without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Project ID | The numeric identifier of the project where people will be managed. |
| Grant Access To | An array of person IDs to whom access should be granted on the specified project. |
| Revoke Access From | An array of person IDs from whom access should be revoked on the specified project. |
| Create People | An array of new people objects to be created and added to the project. |
| Return Full Response | Boolean flag indicating whether to return the full HTTP response (status code, headers, body) or just the response body. |
Output
The node outputs JSON data representing the result of the manage people operation on the project. This typically includes information about the updated project membership after granting, revoking, or creating people.
If the "Return Full Response" property is enabled, the output will include the entire HTTP response object, including status code, headers, and body. Otherwise, only the response body is returned.
The node does not output binary data.
Dependencies
- Requires an authenticated connection to the Basecamp API using OAuth2 credentials.
- Needs the Basecamp account ID configured in the credentials to construct the API base URL.
- The node sends requests to the Basecamp API endpoints related to project people management.
Troubleshooting
- Invalid Project ID: If the provided project ID does not exist or is incorrect, the API will likely return an error. Verify the project ID before running the node.
- Incorrect Person IDs: Granting or revoking access requires valid person IDs. Using invalid or non-existent IDs may cause errors or partial failures.
- API Authentication Errors: Ensure that the OAuth2 credentials are correctly set up and have sufficient permissions to manage project people.
- Malformed Input Arrays: The properties for granting, revoking, and creating people expect arrays. Providing malformed JSON or incorrect data types can cause request failures.
- Full Response Handling: When enabling "Return Full Response," downstream nodes must handle the full HTTP response structure instead of just the body.