Basecamp icon

Basecamp

Interact with Basecamp API
Join our community

Actions119

Overview

This node allows users to create a new schedule entry within a specified project and schedule in Basecamp. It is useful for automating the addition of events or appointments to a team's calendar, ensuring that all relevant participants are informed and that the event details are properly recorded.

Common scenarios include:

  • Automatically scheduling meetings or deadlines based on external triggers.
  • Adding reminders or important dates to a project timeline.
  • Coordinating team availability by creating shared calendar entries.

For example, you could use this node to create a schedule entry for a project kickoff meeting, specifying the start and end times, summary, description, and participants, and optionally notify them about the event.

Properties

Name Meaning
Project ID The numeric ID of the project (bucket) where the schedule entry will be created.
scheduleId The numeric ID of the schedule within the project where the entry will be added.
Summary A brief text summary describing what the schedule entry is about.
Start Date/Time The ISO 8601 formatted date and time when the schedule entry starts.
End Date/Time The ISO 8601 formatted date and time when the schedule entry ends.
Description More detailed information about the schedule entry; can include HTML formatting.
Participant IDs A string representing the IDs of people participating in the schedule entry.
All Day Event Boolean flag indicating if the schedule entry should be treated as an all-day event.
Send Notifications Boolean flag indicating whether to notify participants about the schedule entry.
Return Full Response Boolean flag to determine if the full API response (status code, headers, body) should be returned instead of just the response body.

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 other metadata related to the schedule entry.

If the "Return Full Response" property is enabled, the output will include the complete HTTP response including status code and headers, not just the body content.

The node does not output binary data.

Dependencies

  • Requires an active connection to the Basecamp API using OAuth2 authentication with appropriate permissions to create schedule entries.
  • The node expects the Basecamp account ID to be configured in the credentials to construct the API endpoint URL.
  • No additional external dependencies beyond the Basecamp API and n8n's OAuth2 credential setup.

Troubleshooting

  • Invalid Project or Schedule ID: If the provided project or schedule ID does not exist or the user lacks access, the API will return an error. Verify the IDs and permissions.
  • Invalid Date Format: Start and end date/time must be valid ISO 8601 strings. Incorrect formats will cause request failures.
  • Missing Required Fields: Summary, start date/time, end date/time, project ID, and schedule ID are required. Omitting these will result in errors.
  • Notification Failures: If notifications are enabled but participant IDs are invalid or missing, notification sending may fail silently or cause errors.
  • API Rate Limits: Excessive requests may trigger rate limiting by Basecamp. Implement retries or backoff strategies if needed.

Links and References

Discussion