Basecamp icon

Basecamp

Interact with the Basecamp API

Actions80

Overview

This node interacts with the Basecamp API to update project access for people. Specifically, it allows you to modify which people have access to a given project by granting access to some, revoking access from others, and optionally creating new people entries. This is useful in scenarios where you need to manage team permissions dynamically, such as onboarding new members, removing former collaborators, or adjusting access rights based on project needs.

Practical examples include:

  • Granting access to newly assigned team members on a project.
  • Revoking access from people who are no longer part of the project.
  • Creating new people records and assigning them access simultaneously.

Properties

Name Meaning
Project Id The numeric identifier of the project for which access is being updated.
Grant JSON array of people IDs to be granted access to the specified project.
Revoke JSON array of people IDs to be revoked access from the specified project.
Create JSON array of new people objects to be created and added to the project access list.

Output

The node outputs JSON data representing the result of the update operation on project access. This typically includes confirmation of which people were granted or revoked access, and details of any newly created people. The exact structure depends on the Basecamp API response but generally reflects the updated state of project access.

No binary data output is involved.

Dependencies

  • Requires an API authentication token credential for Basecamp (OAuth2 or similar).
  • Needs the Basecamp account ID to construct the API base URL.
  • Relies on the Basecamp API endpoint for managing project people access.

Troubleshooting

  • Invalid Project Id: If the project ID does not exist or is incorrect, the API will return an error. Verify the project ID before running the node.
  • Malformed JSON in Grant/Revoke/Create: Since these properties expect JSON arrays, ensure the input is valid JSON. Parsing errors will cause the node to fail.
  • Insufficient Permissions: The API token used must have permission to modify project access. Otherwise, authorization errors will occur.
  • Network Issues: Connectivity problems can cause timeouts or failed requests. Check network status and API availability.

Links and References

Discussion