API call failed due to "MISSING REQUIRED VALUE"

[Patrick]

Problem Statement:

When making an API call, the call failed due to a missing required field "Region". This field is not documented in Knowledge Center, what is this field and why is it required?

Request:

{
  "CONTRACTEFFECTIVEDATE": "2015-11-03",
  "PREVIEWACCOUNTINFO": {
  "BILLCYCLEDAY": 0,
  "BILLTOCONTACT": {
    "CITY": "SAN FRANCISCO",
    "COUNTRY": "USA",
    "STATE": "CALIFORNIA",
    "ZIPCODE": "12345"
  },
  "CURRENCY": "USD"
  },
  "SUBSCRIBETORATEPLANS": [
    {
     "PRODUCTRATEPLANID": "2C92C0F94F87BD1C014F942305522D0A"
    }
  ],
  "TERMTYPE": "EVERGREEN"
}

Response:

{
   "REASONS": [
     {
        "MESSAGE": "MISSING REQUIRED VALUE: (ACCOUNT'S REGION)",
        "CODE": 53100022
     }
   ],
   "PROCESSID": "9AF44BBA56204372",
   "SUCCESS": FALSE
}

[Patrick · Accepted solution]

Solution:

The "Region" field was a custom field marked as "Required" when it was defined in the Account object. Simply uncheck the box "required" in the custom field settings to resolve the issue.

Supporting Documentation:

https://knowledgecenter.zuora.com/kb/How_do_I_use_custom_fields%3F