Basecamp icon

Basecamp

Interact with the Basecamp API
Join our community

Actions80

Overview

This node allows you to create a new schedule entry within a specified schedule and bucket in the Basecamp system. It is useful for automating calendar or project management workflows where you want to programmatically add events or tasks with specific timing, participants, and details.

Common scenarios include:

  • Automatically scheduling meetings or deadlines based on triggers from other systems.
  • Creating reminders or events for team members without manual input.
  • Integrating Basecamp schedules with other calendar or task management tools.

For example, you could use this node to create a schedule entry for a project kickoff meeting that includes all relevant participants, specifies start and end times, and provides a detailed description.

Properties

Name Meaning
Bucket Id Numeric identifier of the bucket where the schedule entry will be created.
Schedule Id Numeric identifier of the schedule to which the entry belongs.
Summary A brief title or summary describing what the schedule entry is about.
Starts At The start date and time of the schedule entry in ISO 8601 format.
Ends At The end date and time of the schedule entry in ISO 8601 format.
Description Additional information about the schedule entry; supports HTML formatting.
Participant Ids JSON array of participant IDs who will be involved in the schedule entry.
All Day Boolean flag indicating if the event lasts all day (true) or has specific times (false).
Notify Boolean flag indicating whether participants should be notified about the entry.

Output

The node outputs JSON data representing the newly created schedule entry as returned by the Basecamp API. This typically includes details such as the entry's unique ID, timestamps, summary, description, participant information, and notification status.

If the node supports binary data output, it would relate to attachments or files associated with the schedule entry, but this operation focuses on JSON data only.

Dependencies

  • Requires an API key credential for authenticating with the Basecamp API.
  • Needs the Basecamp account ID to construct the correct API base URL.
  • The node depends on the Basecamp API being accessible and the user having permissions to create schedule entries in the specified bucket and schedule.

Troubleshooting

  • Invalid or missing Bucket Id or Schedule Id: Ensure these numeric IDs are correct and correspond to existing buckets and schedules in your Basecamp account.
  • Incorrect date formats: The Starts At and Ends At fields must be valid ISO 8601 strings; otherwise, the API may reject the request.
  • Participant Ids parsing errors: The participant IDs must be provided as a valid JSON array; malformed JSON will cause failures.
  • Permission errors: If the API credentials lack sufficient rights, creation will fail with authorization errors.
  • Notification issues: If notifications are disabled (Notify set to false), participants won't receive alerts, which might cause confusion.

To resolve errors, verify all inputs carefully, check API credentials, and consult Basecamp API documentation for error codes.

Links and References

Discussion