Basecamp icon

Basecamp

Interact with Basecamp API

Actions76

Overview

This node interacts with the Basecamp API to retrieve questions associated with a specific questionnaire within a project. It is useful for workflows that need to fetch survey or form questions from Basecamp projects, such as automating data collection, analysis, or reporting based on questionnaire content.

Typical use cases include:

  • Extracting all questions from a given questionnaire to display or process elsewhere.
  • Integrating Basecamp questionnaire data into other systems or dashboards.
  • Automating follow-up actions based on the questions defined in a project’s questionnaire.

Properties

Name Meaning
Project ID The numeric ID of the project (bucket) where the questionnaire resides; used in the API path.
Questionnaire ID The numeric ID of the questionnaire to get questions from; used in the API path.
Return All Results Boolean option to return all available questions or limit the output to a default maximum.
Return Full Response Boolean option to return the entire HTTP response including status code and headers instead of just the response body.

Output

The node outputs JSON data representing the questions retrieved from the specified questionnaire. The structure typically includes an array of question objects, each containing details such as question text, type, and identifiers.

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

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 user to provide valid project and questionnaire IDs.
  • Network access to Basecamp's API endpoint is necessary.
  • No additional external services or environment variables are required beyond the configured API credentials.

Troubleshooting

  • Invalid Project or Questionnaire ID: If the provided IDs do not exist or the user lacks permission, the API may return errors or empty results. Verify IDs and access rights.
  • API Authentication Errors: Ensure the OAuth2 credentials are correctly set up and have not expired.
  • Pagination Issues: When "Return All Results" is false, only a limited number of questions are returned. Enable it to fetch all pages if needed.
  • Network or Rate Limiting Errors: Check network connectivity and Basecamp API rate limits if requests fail or time out.

Common error messages might include unauthorized access, resource not found, or invalid parameters. Resolving these usually involves checking credentials, input values, and API permissions.

Links and References

Discussion