Actions80
- Card Tables Actions
- Forwards Actions
- Events Actions
- Recordings Actions
- Projects Actions
- People Actions
- Chatbots Actions
- Webhooks Actions
- Attachments Actions
- Templates Actions
- Uploads Actions
- Documents Actions
- Lineup Markers Actions
- Subscriptions Actions
- Schedules Actions
- Schedule Entries Actions
- Todo Sets Actions
- Todo Lists Actions
- Todos Actions
Overview
This node operation updates subscriptions for a specific recording within a bucket in the Basecamp service. It allows adding and removing people from subscription lists associated with a particular recording. This is useful in scenarios where you want to manage who receives notifications or updates related to certain recordings, such as project meetings, audio logs, or other recorded content.
Practical examples include:
- Adding team members to receive updates about a new meeting recording.
- Removing users who no longer need to be notified about changes to a recording.
- Managing subscription lists dynamically based on project roles or changes in team composition.
Properties
| Name | Meaning |
|---|---|
| Bucket Id | The numeric identifier of the bucket containing the recording to update subscriptions for. |
| Recording Id | The numeric identifier of the recording whose subscriptions are being updated. |
| Subscriptions | A JSON array of person IDs to subscribe (add) to the recording's subscription list. |
| Unsubscriptions | A JSON array of person IDs to unsubscribe (remove) from the recording's subscription list. |
Output
The node outputs JSON data representing the result of the subscription update operation. This typically includes confirmation of the updated subscription state or any relevant metadata returned by the Basecamp API after processing the request.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating with the Basecamp API.
- The node uses the Basecamp API endpoint constructed with the user's Basecamp account ID.
- Proper permissions on the Basecamp account to modify subscriptions on recordings are necessary.
Troubleshooting
- Invalid Bucket or Recording Id: If the provided bucket or recording IDs do not exist or are incorrect, the API will likely return an error. Verify these IDs before running the node.
- Malformed JSON in Subscriptions/Unsubscriptions: Since these fields expect JSON arrays, ensure the input is valid JSON. Invalid JSON will cause parsing errors.
- Insufficient Permissions: Errors related to authorization may occur if the API key does not have rights to update subscriptions. Check API credentials and permissions.
- Empty Subscription Arrays: Providing empty arrays might result in no changes; confirm that the intended user IDs are correctly specified.
Links and References
- Basecamp API Documentation
- n8n Documentation on HTTP Request Nodes (for understanding how API calls are made)
- JSON formatting tools for validating subscription/unsubscription inputs