Update Services

Denotes the distinctive ID of the service which has to be updated. Make a GET Services API call to get the IDs of services.

Represents the amount of time for which the particular service is offered.
Possible Values: Values are accepted only in minutes. It should be greater than 15 minutes and less than 1,440 minutes.

Provides the location where the service is offered.
Possible Values: 'Client Address', 'Business Address' and 'Business Address and Client Address'.

Contains the ID of users who perform the service. You can add up to 100 members for a service.

Denotes the available days of service for customers.
Possible Values: 'Every Business Days', 'Specific Date Range', 'Specific Date(s)', and 'Specific Day(s)'.
The availability type is changed from specific days to specific date range in the sample input.

Denotes the date from which the service is available for customers.

Denotes the date until which the service is available for customers.

Contains the available time of service for the customers in the specified available days/dates. A maximum of two custom timings can be fed. Note that the customized available time should be equal or greater than the service duration. The default value is the same as the configured business hours of the organization.

Contains the id and value of the tax applied to the service cost. You can fetch the tax IDs and values from the GET Fields API of Services module.
A couple of taxes were added for your reference in the sample input.

Denotes whether the members have to fill a job sheet at the end of each service appointments.
Possible Values: 'Yes' and 'No'. The default value is No.
Sample input is provided for disabling job sheet from a service.

Represents the Job Sheet which has to be associated with the service. You can make a GET Fields API call to get the available job sheets in your organization. To disable job sheet for a service, this key has to be given 'null' value.

Denotes whether the service is active.
Possible Values: 'Available', 'Temporarily Unavailable' and 'Not in Use'. The default value is available.
The status is changed from Available to Temporarily Unavailable for a couple of weeks in the sample input for your understanding.

Represents the date and time from which the service is unavailable for customers. The values cannot be greater than the current time. Also, it should be given in the ISO 8601 format.

Represents the date and time until which the service is unavailable for customers. It should be given in the ISO 8601 format.

You have failed to provide the dependent fields of Availability_Type, Status and Job_Sheet_Required keys.
Solution: Check the Request JSON Keys section and specify the dependent fields.

You have given an invalid value for Unavailable_Till.
Solution: When the status is temporarily unavailable, the value of 'Unavailable_Till' should be greater than the current time. The value of the same key should be less than the current time if the status is available.

Either 'Unavailable_From' or 'Unavailable_Till' is given with available status.
Solution: When the status is available, you can choose either not to specify 'Unavailable_From' and 'Unavailable_Till' keys or specify them both. You cannot specify only one of the keys.

When Job_Sheet_Required key is given 'No', you cannot specify the Job-Sheet_Section__s.
Solution: Job_Sheet_Section__s should be provided, only when Job_Sheet_Required is given 'Yes'.

The specified Available Timings, Available_Days or Available_Dates do not fall within the business hours or business days of the organization.
Solution: Make a GET Business Hours API call and specify a valid input within the business hours of your organization.

You have given an invalid Availability_Type.
Solution: You should specify any one of these 'Every Business Days', 'Specific Date Range', 'Specific Date(s)', and 'Specific Day(s)' picklist values.

The date specified in the Available_Dates key follows an invalid format.
Solution: Use only the YYYY-MM-DD format for dates.

Either the 'From' or 'To' key in the Available_Timings is invalid.
Solution: The custom available timings must be given in the 24 hour time format.

You have specified an invalid Duration value.
Solution: Duration cannot be less than 15 minutes and greater than 1,440 minutes. Note that the value should always be in minutes.

The specified Available_Timings does not satisfy the service duration.
Solution:The value of Available_Timings key should be equal or greater than the service duration.

You have given an invalid Status value.
Solution: The only possible values are 'Available','Temporarily Unavailable' and 'Not in Use'.

You have given an invalid value for Unavailable_From.
Solution: Ensure that the value of 'Unavailable_From' is not greater than the current time.

You have specified either an unconfirmed or inactive user ID in the Members key.
Solution: You can add only active and confirmed users as a part of service members in your organization.

The value for Available_Till key is not greater than the value of Available_From key.
Solution: When the Availability_Type of a service is 'Specific Date Range', the Available_Till date should be greater than the Available_From date.

The module name in the request URL seems to be invalid.
Solution: You can use only Services__s in the request URL.

The given http request method type is invalid.
Solution: Use only the PUT method in the request URL to access this API.

You have exceeded the maximum limit either for members in a service or the number of active services in an organization.
Solution: You are allowed to add only up to 100 members to a service. The maximum number of active services in an organization is 500.

The token you used has been created using the wrong oauth scope.
Solution: Use either ZohoCRM.modules.services.CREATE or ZohoCRM.modules.services.ALL scope to create a new valid token.

You have used an invalid oauth token.
Solution: The token you used has expired. Kindly refresh your token and retry.

You do not have permission to post any services.
Solution:Contact your system administrator.

Job Sheet is not configured for your organization in service preferences.
Solution: Enable the job sheet preference before creating services with job sheets. You can update the configurations using the Update Service Preferences API.

You have specified the 'Available' status when the service availability dates are in the past.
Solution: You cannot mark a service as available or temporarily unavailable when the Available_Dates are in the past.

Check if you are trying to access the correct URL.
Solution: You have given an invalid request URL. Use only /Services__s endpoint to provide a valid URL.

Internal Server Error
Solution: Unexpected and unhandled exception in the server. Please contact our support team.