3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

The "Update Holiday" operation in the Holidays resource allows users to modify an existing holiday entity within the 3CX telephony system. This node is useful for automating updates to holiday schedules, such as changing dates, names, or recurrence settings of holidays that affect call routing or availability in the telephony system.

Practical examples include:

  • Updating a holiday's date range when a public holiday changes.
  • Changing the name or description of a holiday for clarity.
  • Adjusting whether a holiday recurs annually or is a one-time event.

Properties

Name Meaning
Id The unique identifier of the holiday entity to update. Can be set via expression (e.g., {{$json.Id}}).
Day The starting day of the holiday (numeric).
Day End The ending day of the holiday (numeric), if the holiday spans multiple days.
Holiday Prompt A descriptive prompt or message associated with the holiday.
Is Recurrent Boolean indicating if the holiday recurs annually (true) or is a one-time event (false).
Month The starting month of the holiday (numeric).
Month End The ending month of the holiday (numeric), if applicable.
Name The name of the holiday.
Time Of Start Date The start time on the first day of the holiday (string, e.g., "09:00").
Time Of End Date The end time on the last day of the holiday (string, e.g., "17:00").
Year The starting year of the holiday (numeric).
Year End The ending year of the holiday (numeric), if applicable.

Output

The node outputs JSON data representing the updated holiday entity after the operation completes. This typically includes all the fields sent in the update request along with any additional metadata returned by the 3CX API confirming the update.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the 3CX telephony system API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for the 3CX API must be correctly set in the credentials configuration.

Troubleshooting

  • Invalid Id Error: If the provided holiday Id does not exist, the API will return an error. Ensure the Id is correct and accessible.
  • Authentication Failures: Errors related to authorization indicate issues with the API key or OAuth2 token. Verify credential setup.
  • Invalid Date or Time Format: Providing invalid numeric values for day/month/year or incorrect time strings may cause errors. Validate input formats.
  • Partial Updates Not Applied: All required fields should be included; missing critical fields might result in incomplete updates.

Links and References

Discussion