Shift Hours

Represents the time zone you want to set the shift hours for.

The name of the shift hours. Note that the special characters ~ , ` , # , % , & , + , = , [ , ] , { , } , | , ; , < , > , ^ are not allowed.

The days of the week you want to set the shift hours for. Note that you can set shift timing only on the days your business operates on.

Represents whether the shift hours are the same everyday. When this value is false, the JSON array custom_timing becomes mandatory. When this value is true, the JSON array daily_timing becomes mandatory.

Represents the shift timing for the week in the HH:mm format. For example: "daily_timing":["10:00","17:00"].

Contains the following keys in every JSON object of the array:

• days - string, mandatory - The day of the week that has a custom time for the shift. Example: "days":"Monday".
• shift_timing - JSON array, mandatory - The shift timing on that day in the HH:MM format. For example: "shift_timing":["10:00","17:00"].

Contains the following keys in every JSON object of the array:

• same_as_everyday - Boolean, mandatory - true represents that the break hours are the same everyday, and daily_timing is mandatory. When this value is false, the custom_timing array becomes mandatory.
• break_days - JSON array, mandatory - The days of the week break hours are allowed.
• daily_timing(when same_as_everyday is true) - JSON array, mandatory - The break timing on that day in the HH:MM format. For example: "daily_timing":["10:00","10:30"]. Note that break hours cannot exceed two hours per day, and a day can have only two breaks.

• custom_timing(when same_as_everyday is false) - JSON array, mandatory - The break timing on a day in the HH:MM format. For example: "custom_timing":["11:00","01:00"]. Note that break hours cannot exceed two hours per day, and a day can have only two breaks.

  
  days - string, mandatory - The day of the shift the custom break timing applies to.

Use this array to create a new holiday while creating a shift hour.
This array must contain the following keys:

• name - string, mandatory - The unique name of the holiday. Note that the special characters ~ , ` , # , % , & , + , = , [ , ] , { , } , | , ; , < , > , ^ are not allowed.
• date - string, mandatory - The date in the YYYY-MM-DD format that the holiday falls on.

The ID of the user who you want to assign these shift hours to. Use the key effective_from to assign this shift to the user on this date. The format is YYYY-DD-MM.
When you do not specify this key, the user gets assigned to the shift immediately.

Reasons:

• One or more of these data is invalid - shift timing, timezone, break timing, effective from date.
• The input contains more than two break hour timings.
• The input contains more than seven shift days or break days.
• The shift name contains one or more special characters - ~ , ` , # , % , & , + , = , [ , ] , { , } , | , ; , < , > , ^.
• The break hours overlap.
• The break hours fall outside the shift hours.
• The effective from date is not greater than the current date.

Resolution:
Refer to the "details" key in the response for the API name of the field that has the error in the input.

You have not specified either the name of the shift hour or the timezone in the input.
Resolution: The name and the timezone of the shift hours are mandatory in the input. Refer to the details key in the response to find out the missing key.

You have not specified one or more of the dependent fields.
Resolution:

• For custom shift hours, days is mandatory.
• When same_as_everyday=true, daily_timing is mandatory.
• When same_as_everyday=false, custom_timing is mandatory.

Refer to the sample input for the structure of each of these keys.

You are trying to create more than 50 shift hours for your org.
Resolution: An org can have a maximum of 50 shift hours.

You are trying to set shift hours before setting up business hours for your org.
Resolution: You can add shift hours only after you add business hours.

You are trying to set break hours for more than two hours.
Resolution: Each shift can have a break timing of a maximum of two hours.

Please check if the URL trying to access is a correct one
Resolution: The request URL specified is incorrect. Specify a valid request URL. Refer to the request URL section above.

You do not have the right scope to access this API.
Resolution: Create new token with ZohoCRM.settings.business_hours.ALL or ZohoCRM.settings.business_hours.CREATE scopes.