Basecamp icon

Basecamp

Interact with Basecamp API

Actions76

Overview

This node integrates with the Basecamp API to create a new question within a specified project and questionnaire. It is useful for automating the process of adding questions to surveys or questionnaires managed in Basecamp projects. For example, a user can programmatically add feedback questions to a customer satisfaction survey or insert polling questions into team questionnaires without manual entry.

Properties

Name Meaning
Project ID The numeric ID of the project (bucket) where the question will be created.
questionnaireId The numeric ID of the questionnaire within the project to which the question belongs.
Content The text content of the question, supporting HTML formatting.
Schedule A string representing the schedule associated with the question (format depends on API).
Presenting Group (JSON) JSON string array of person IDs who will be asked to answer this question.
Return Full Response Boolean flag indicating whether to return the full HTTP response (status, headers, body) or just the response body.

Output

The node outputs the response from the Basecamp API after creating the question. By default, it returns only the response body containing details of the newly created question. If "Return Full Response" is enabled, the output includes the full HTTP response object with status code, headers, and body. The output is structured as JSON data representing the created question's properties as returned by the API.

Dependencies

  • Requires an active connection to the Basecamp API using OAuth2 authentication.
  • Needs the Basecamp account ID configured in credentials to construct the API base URL.
  • The node expects valid project and questionnaire IDs that exist in the Basecamp account.

Troubleshooting

  • Invalid Project or Questionnaire ID: If the provided IDs do not exist or are incorrect, the API will return an error. Verify the IDs before running the node.
  • Authentication Errors: Ensure the OAuth2 credentials are correctly set up and have sufficient permissions to create questions.
  • Malformed JSON in Presenting Group: The "Presenting Group (JSON)" must be a valid JSON string representing an array of person IDs. Invalid JSON will cause request failures.
  • Schedule Format Issues: The schedule property must conform to the expected format by the Basecamp API; otherwise, the request may be rejected.
  • API Rate Limits: Frequent requests might hit rate limits imposed by Basecamp; handle such errors by retrying after some delay.

Links and References

Discussion