Actions252
- Api Keys Actions
- Attachments Actions
- Blocklists Actions
- Calendar Channel Event Associations Actions
- Find Many Calendar Channel Event Associations
- Create One Calendar Channel Event Association
- Create Many Calendar Channel Event Associations
- Find One Calendar Channel Event Association
- Delete One Calendar Channel Event Association
- Update One Calendar Channel Event Association
- Find Calendar Channel Event Association Duplicates
- Companies Actions
- Calendar Channels Actions
- Calendar Event Participants Actions
- Calendar Events Actions
- Connected Accounts Actions
- Favorite Folders Actions
- Favorites Actions
- Message Channel Message Associations Actions
- Find Many Message Channel Message Associations
- Create One Message Channel Message Association
- Create Many Message Channel Message Associations
- Find One Message Channel Message Association
- Delete One Message Channel Message Association
- Update One Message Channel Message Association
- Find Message Channel Message Association Duplicates
- Message Channels Actions
- Message Folders Actions
- View Fields Actions
- Message Participants Actions
- Messages Actions
- Message Threads Actions
- Notes Actions
- Note Targets Actions
- Opportunities Actions
- People Actions
- Tasks Actions
- Task Targets Actions
- Timeline Activities Actions
- View Filter Groups Actions
- View Filters Actions
- View Groups Actions
- Views Actions
- View Sorts Actions
- Webhooks Actions
- Workflow Automated Triggers Actions
- Workflow Runs Actions
- Workflows Actions
- Workflow Versions Actions
- Workspace Members Actions
Overview
This node operation updates a single calendar channel object in an external calendar system. It allows modifying various attributes of the calendar channel such as its synchronization status, visibility, sync stage, and related settings. This is useful for keeping calendar channel metadata up to date, managing sync behavior, or adjusting access and contact creation policies programmatically.
Practical examples include:
- Changing the sync status of a calendar channel after resolving sync errors.
- Updating visibility settings to control sharing permissions.
- Adjusting contact auto-creation policies based on organizational needs.
- Setting sync cursors or timestamps to manage incremental syncing.
Properties
| Name | Meaning |
|---|---|
| Id | The unique identifier of the calendar channel object to update. |
| Depth | Level of nested related objects to include in the response: 0 (only primary object), 1 (primary + directly related objects), 2 (primary + related + their related objects). |
| Handle | A string handle or identifier for the calendar channel. |
| Sync Status | Current synchronization status of the calendar channel. Options: ONGOING, NOT SYNCED, ACTIVE, FAILED INSUFFICIENT PERMISSIONS, FAILED UNKNOWN. |
| Sync Stage | Current stage of the synchronization process. Options: FULL CALENDAR EVENT LIST FETCH PENDING, PARTIAL CALENDAR EVENT LIST FETCH PENDING, CALENDAR EVENT LIST FETCH ONGOING, CALENDAR EVENTS IMPORT PENDING, CALENDAR EVENTS IMPORT ONGOING, FAILED. |
| Visibility | Visibility level of the calendar channel. Options: METADATA, SHARE EVERYTHING. |
| Is Contact Auto Creation Enabled | Boolean flag indicating if automatic creation of contact records from event participants/organizers is enabled. |
| Contact Auto Creation Policy | Policy defining how contacts are automatically created from events. Options: AS PARTICIPANT AND ORGANIZER, AS PARTICIPANT, AS ORGANIZER, NONE. |
| Is Sync Enabled | Boolean flag indicating if synchronization is enabled for this calendar channel. |
| Sync Cursor | A string cursor used to track sync progress with the calendar provider. |
| Synced At | Timestamp string representing the last time the calendar channel was synced. |
| Sync Stage Started At | Timestamp string representing when the current sync stage started. |
| Throttle Failure Count | Number of times sync requests have failed due to throttling. |
| Connected Account Id | Identifier of the connected account associated with this calendar channel. |
Output
The node outputs JSON data representing the updated calendar channel object. The structure includes the primary calendar channel fields and, depending on the depth parameter, may include nested related objects up to two levels deep. This output reflects the new state of the calendar channel after the update operation.
No binary data output is indicated.
Dependencies
- Requires an API key credential to authenticate requests to the external calendar service.
- The base URL for API requests is configured via credentials.
- The node uses HTTP headers to accept and send JSON content.
- No additional external dependencies are indicated beyond the API connection.
Troubleshooting
- Invalid Id: If the provided calendar channel ID does not exist, the API will likely return a "not found" error. Verify the ID before updating.
- Permission Errors: Sync status options like "FAILED INSUFFICIENT PERMISSIONS" indicate permission issues; ensure the API key has sufficient rights.
- Throttle Failures: High throttle failure counts suggest rate limiting; consider reducing request frequency or handling retries with backoff.
- Invalid Property Values: Providing unsupported enum values for properties like syncStatus or visibility will cause validation errors.
- Missing Required Fields: The
idproperty is required; omitting it will prevent the update.
Links and References
- Refer to the external calendar API documentation for detailed descriptions of calendar channel fields and sync states.
- Consult n8n documentation on configuring API credentials and using HTTP request nodes for custom integrations.