Unable to Change or Publish Schedules in Twilio Flex Schedule Manager – Twilio Support

Issue

The Contact Center Schedule Manager plugin in Twilio Flex allows you to manage when your contact center accepts calls by configuring schedules. Occasionally, you may encounter issues when trying to change or publish these schedules. This article provides troubleshooting steps and explains common causes for errors when updating schedules in Flex.

The following is a list of the most common symptoms:

You attempt to change your Flex schedule (e.g., business hours) and click “Publish,” but receive an error message.
The schedule does not update as expected, and your team cannot accept calls during the intended hours.

Product

Twilio Flex

Environment

legacy Twilio Console

Cause

Node.js Version Compatibility

Flex plugins and Functions may require a specific Node.js runtime version. If your Functions are running on an outdated Node.js version (such as Node 18), you may encounter errors when updating schedules.
Solution: Upgrade your Functions to use Node.js 22. Learn how to upgrade Node.js for Twilio Functions.

Functions Created via API Are Not UI Editable

If your Flex schedules are managed by Twilio Functions created via the API (rather than the Twilio Console), these Functions are not editable through the UI by default.
Solution: Update your Functions service to make it UI-editable. You can do this by setting the UiEditable property to true using the Twilio Serverless API.

Example cURL Request

curl -X POST "https://serverless.twilio.com/v1/Services/{ServiceSid}" \
  --data-urlencode "UiEditable=true" \
  -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Replace {ServiceSid} with your actual Service SID.

See the API documentation for more details.

Configuration or Browser Issues

Incomplete or conflicting schedule configurations can cause errors.
Browser cache or extension issues may also interfere with the Flex UI.

Resolution

Check Node.js Version

Ensure your Functions are running on Node.js 22.

Make Functions UI-Editable

If you created Functions via API, update the service as described above.

Review Schedule Configuration

Double-check that all required fields are filled and there are no overlapping schedules.

Clear Browser Cache

Try clearing your browser cache or using an incognito window.

Collect Logs for Further Investigation

If the issue persists, collect browser console and HAR logs to help diagnose the problem. Learn how to collect browser logs for Flex.

Additional Information

If you continue to experience issues after following these steps, gather the following information before reaching out for support:

The exact error message you see
Whether you are updating the schedule via the UI or API
Screenshots or logs showing the error

This information will help the support team resolve your issue more quickly.