Basecamp icon

Basecamp

Interact with the Basecamp API
Join our community

Actions68

Overview

This node allows you to create a webhook in Basecamp by specifying the target bucket, the URL that Basecamp should call when the webhook is triggered, and the types of events that will trigger the webhook. It is useful for automating workflows that depend on real-time notifications from Basecamp, such as syncing project updates, triggering alerts, or integrating with other systems.

For example, you can use this node to set up a webhook that notifies your application whenever a new message is posted in a specific Basecamp bucket, enabling instant processing or logging of those messages.

Properties

Name Meaning
Bucket Id The numeric identifier of the Basecamp bucket where the webhook will be created.
Payload Url The HTTPS URL that Basecamp will call when the webhook is triggered.
Types An array of event types that will trigger the webhook calls. Specify which events to listen for.

Output

The node outputs JSON data representing the created webhook object returned by the Basecamp API. This typically includes details such as the webhook ID, associated bucket, subscribed event types, and the callback URL.

No binary data output is produced by this node.

Dependencies

  • Requires an API authentication token credential configured in n8n to authenticate requests to the Basecamp API.
  • The node uses the Basecamp API endpoint constructed dynamically based on the authenticated user's Basecamp account ID.
  • Network access to the specified Payload URL must be allowed for Basecamp to successfully send webhook calls.

Troubleshooting

  • Invalid Bucket Id: If the provided bucket ID does not exist or is inaccessible, the API will return an error. Verify the bucket ID is correct and accessible with the authenticated credentials.
  • Invalid Payload URL: The Payload URL must be a valid HTTPS URL reachable by Basecamp. Ensure it is correctly formatted and publicly accessible.
  • Incorrect Event Types Format: The Types property expects a JSON array. Invalid JSON or unsupported event types may cause errors. Validate the JSON syntax and refer to Basecamp documentation for supported event types.
  • Authentication Errors: Missing or invalid API credentials will prevent webhook creation. Confirm that the API key or OAuth token is properly configured in n8n.
  • Network Issues: Connectivity problems between n8n and Basecamp API endpoints can cause failures. Check network settings and firewall rules.

Links and References

Discussion