Add Till with Existing Custom Fields

This API enables you to create a new till for your store and attach existing custom fields to store information specific to the till. The till level custom fields enables brands to add additional information about the till specially when the brand has multiple tills mapped to a store. For example, till code, till name, description about till etc.



For detailed information about our APIs and for hands-on testing, refer documentation in API overview and step-by-step guide on making your first API call in Make your first API call .

API endpoint example


  • Authentication - Basic or OAuth authentication details
  • Access group resource - Access to Organisation resource
  • Configuration - If you want to create more than five custom fields, create a ticket to the sustenance team and increase the limit in the configuration PRODUCT_CONF_ORG_AUDITABLE_CUSTOM_FIELDS_LIMIT. By default, the maximum value is set as five.

Resource information

Rate limitDefault
Batch supportNA

Request body parameters

(Parameters marked with * are mandatory)
descriptionstringDescription for the till.
storeId*longStore ID of the parent Store to which the till has to be created and attached.
password*stringPassword for the till
billablebooleanSpecify if the till is used for billing. By default, the value is set as true.
name*stringName for the till. The till name specified will be copied to till code as well in the backend.
customFieldsarray-objSpecify the Custom fields to be attached to the till that already exists in the org.
  "description": "Testing description",
  "storeId": 50154731,
  "password": "123",
  "billable": true,
  "name": "new_till_2",
  "customFields": [
      "name": "cf_1",
      "value": "16"

Response parameters

ParameterData typeDescription
createdIdIntThe till ID created.
warningsStringWarnings if any.
    "createdId": 50156997,      //createdId specifies the created TillId 
    "warnings": []

API-specific error codes

Error codeDescription
1207Till name already exists. Use a unique name.
1214The parent store is not valid. Use a valid parent store ID
1023The number of custom fields that can be created is reached. In the org settings, increase the limit of PRODUCT_CONF_ORG_AUDITABLE_CUSTOM_FIELDS_LIMIT. Default value: 5.
1024The custom field parameter is null or empty. Enter a value for the parameter.
1025There are multiple custom fields with the same name. Use a unique custom field name.
Click Try It! to start a request and see the response here!