Create Services

Represents the name of the service and it accepts alphanumeric characters.

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 lesser 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)'.

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

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

Contains the list of dates on which the service is available for customers. You can provide a maximum of 20 business dates. The values must follow the YYY-MM-DD format.

Contains the list of business days on which the service is available for customers.

Denotes the cost allocated for the service. It takes the locale currency value configured in your organization. You can specify a maximum of 16 digits with 2 decimal places.

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 to or greater than the service duration.
The default value is the same as the configured business hours of the organization.
The value of 'From' and 'To' keys must be given in the 24 hour time format.

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.

Denotes whether the members have to fill in a job sheet at the end of each service appointment.
Possible Values: 'Yes' and 'No'. The default value is No.

Represents the Job Sheet which has to be associated with the service. Make a GET Fields API call to get the details of available job sheets in your organization. When Job_Sheet_Required is given 'No', the Job_Sheet_Section__s can either be null or not specified.

Denotes whether the service is active.
Possible Values: 'Available', 'Temporarily Unavailable' and 'Not in Use'. The default value is Available.

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.

Represents the description of the service, if any.

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.

You have given either 'Unavailable_From' or 'Unavailable_Till' keys 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 you have specified the Job_Sheet_Required key as '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.

You have given an invalid date format for the Available_Dates key.
Solution: Use only YYYY-MM-DD format for dates.

You have specified an invalid value for either the 'From' or 'To' key in the Available_Timings.
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.

Your value for 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.

You have given an invalid module name in the request URL.
Solution: You can use only Services__s in the request URL.

You have specified an invalid http request method type.
Solution: Use only the POST 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.

You created the grant token using the wrong oauth scope.
Solution: Use either ZohoCRM.modules.services.CREATE or ZohoCRM.modules.services.ALL scope to create a new valid grant token.

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

You do not have permission to create 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 in the URL.

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