Add new value(s) to a field

Reading Time: 2 minutes

Values can be added to a project’s field.

Method POST
Resource https://[customer][projectid]/fields/[fieldid]/values
Options N/A
Body Array of value objects, encoded in JSON.
Body New valueID(s), encoded in JSON.


Resource parameters

Name Type Mandatory Comment
customer string yes Your call centre’s unique identifier (subdomain).
fieldid integer yes Field identifier.
projectid integer yes Unique project identifier.

Request object

Name Type Mandatory Comment
array yes Array of value objects.

Value object

Name Type Mandatory Comment
comission string no Agent’s commission.
description string no Simple description.
exportvalue string no Value’s export name.
name string yes Value name.
price string no Call centre’s commission.




Request body

        "name": "high school",
        "exportvalue": "HS",
        "description": "high school graduate",
        "commission": "100",
        "price": "200"
        "name": "university",
        "exportvalue": "U",
        "description": "university degree",
        "commission": "10",
        "price": "20"

Response body – on success

    "errors": [],
    "response": [

Response body – on error

    "errors": [
            "errorcode": 417,
            "index": 1,
            "errormessage": "error.name_must_be_between",
            "property": "name"
            "errorcode": 417,
            "index": 3,
            "errormessage": "error.name_must_be_between",
            "property": "name"
            "errorcode": 417,
            "index": 6,
            "errormessage": "error.value_name_already_exists",
            "property": "name"
    "response": {
        "0": 8,
        "2": 9,
        "4": 10,
        "5": 11

Possible errors

HTTP Code Message Description
417 error.adding_values_was_unsuccessful Unsuccessful addition, the values were not created due to an error.
417 error.name_must_be_between The name is too short or long.
417 error.value_name_already_exists The value already exists in VCC’s database.
417 error.wrong_value_format Missing value on a mandatory key.
417 error.wrong_values_format The values sent are not correctly defined as an array or object.

There are no comments yet.
Subscribe to our newsletter
or Contact us!
Please note that by subscribing to our newsletter, you agree to receive regular email messages from VCC Live® about service related news and updates. By subscribing to our newsletter, you also agree that VCC Live® will use your data in accordance with the applicable Privacy Policy until you unsubscribe from the newsletter.

Privacy Settings Center


Necessary cookies are essential in order to navigate around a website and use its basic features. You must accept these cookies as the website cannot function properly without them.



Marketing cookies are used to track visitors across websites and deliver advertisements that are more relevant and engaging to you.



Statistic cookies collect data to help us understand how visitors use our websites and are used to improve the user experience. These cookies don’t collect personal information and cannot identify visitors.



Other cookies are those cookies that do not fall into the categories above. These cookies are in the process of being classified.