Sample Prospect Update Request and Response in the JSON Format

Using the below example, you can update the prospect person for 3009626623 prospect person ID.

Sample Prospect Update Request in the JSON Format

{
    "C1-ADDPROSPERSON"
    {
        "prospectPersonId" :"3009626623",
        "actionFlag" :"UPD",
        "prospectPersonName" :"Smith",
        "division" :"930",
        "customerSegment" :"CORP",
        "customerTier" :"T",
        "accessGroup" :"BKUSER",
        "emailAddress" :"smith@example.com",
        "status" :"Active",
        "birthDate" :"2020-01-01",
        "address1" :"401",
        "address2" :"Island Parkway",
        "address3" :"Redwood Shores",
        "address4" :"Redwood Shores",
        "city" :"CA",
        "state" :"New York",
        "country" :"USA",
        "postal" :"94065",
        "prosPerIdentifierList"
        {
            "personIdNumber" :"456",
            "persIsPrimaryId" :"true",
            "idType" :"TAXID",
        }
        "prosChildRelationList"
        {
            "childPersonId" :"0146105591",
            "personRelationshipType" :"PARENT",
            "childPerType" :"PRSP",
            "division" :"930",
            "childPersonIdType" :"Social Security number",
            "childPersonIdNumber" :"3167070400",
            "endDate" :"2025-01-01",
            "startDate" :"2024-01-01",
        }
        "prosParentPerRelationList"
        {
            "parentPersonId" :"1600395396",
            "personRelationshipType" :"CHILD",
            "parentPerType" :"EPER",
            "division" :"930",
            "parentPersonIdType" :"Social Security number",
            "parentPersonIdNumber" :"4598409119",
            "endDate" :"2025-01-01",
            "startDate" :"2024-01-01",
        }
        "prosAccountList"
        {
            "personId" :"6709873933",
            "customerClass" :"BK",
            "accountDivision" :"930",
            "status" :"ACTIVE",
            "setUpDate" :"2024-01-01",
            "currency" :"USD",
            "billCycle" :"ASH3",
            "accountAccessGroup" :"BKUSER",
            "prosAcctCharacteristicList"
            {
                "characteristicValue" :"PROS",
                "effectiveDate" :"2024-01-01",
                "characteristicType" :"C1_F_ANO",
            }
            "prosAcctIdentifierList"
            {
                "accountIdentifierType" :"ACCT_NM",
                "isPrimaryId" :"true",
                "accountNumber" :"PROS",
            }
        }
        "prosPerCharactersticList"
        {
            "personcharacteristicValue" :"I",
            "personEffectiveDate" :"2025-01-01",
            "personCharType" :"C1CUSTAT",
        }
    }
}
Note: If you do not want to enter the data in the list attributes (i.e. attributes where the type is set to list), you should not include them in the request. Adding empty list attributes will give erroneous results.
Sample Prospect Update Response in the JSON Format
{
    "C1-ADDPROSPERSON"
    {
        "prospectPersonId" :"8982132112",
        "actionFlag" :"UPD",
        "prospectPersonName" :"Smith",
        "division" :"930",
        "customerSegment" :"COMM",
        "customerTier" :"T",
        "accessGroup" :"BKUSER",
        "emailAddress" :"smith@example.com",
        "status" :"ACTIVE",
        "birthDate" :"2000-01-01",
        "address1" :"401",
        "address2" :"Island Parkway",
        "address3" :"Redwood Shores",
        "address4" :"Redwood Shores",
        "city" :"CA",
        "state" :"New York",
        "country" :"USA",
        "postal" :"94065",
        "prosPerIdentifierList"
        {
            "personIdNumber" :"456",
            "persIsPrimaryId" :"false",
            "idType" :"PIN",
        }
        {
            "personIdNumber" :"456",
            "persIsPrimaryId" :"true",
            "idType" :"TAXID",
        }
        "prosChildRelationList"
        {
            "childPersonId" :"0146105591",
            "personRelationshipType" :"PARENT",
            "childPerType" :"PRSP",
            "division" :"930",
            "childPersonIdType" :"Social Security number",
            "childPersonIdNumber" :"3167070400",
            "endDate" :"2025-01-01",
            "startDate" :"2024-01-01",
        }
        "prosParentPerRelationList"
        {
            "parentPersonId" :"1600395396",
            "personRelationshipType" :"CHILD",
            "parentPerType" :"EPER",
            "division" :"930",
            "parentPersonIdType" :"Social Security number",
            "parentPersonIdNumber" :"4598409119",
            "endDate" :"2025-01-01",
            "startDate" :"2024-01-01",
        }
        "prosAccountList"
        {
            "personId" :"6709873933",
            "prospectAccountId" :"0017549904",
            "customerClass" :"BK",
            "accountDivision" :"930",
            "status" :"ACTIVE",
            "setUpDate" :"2024-01-01",
            "currency" :"USD",
            "billCycle" :"ASH3",
            "accountAccessGroup" :"BKUSER",
            "prosAcctCharacteristicList"
            {
                "characteristicValue" :"PROS",
                "effectiveDate" :"2024-01-01",
                "characteristicType" :"C1_F_ANO",
            }
            "prosAcctIdentifierList"
            {
                "accountIdentifierType" :"CCT_NM",
                "isPrimaryId" :"true",
                "accountNumber" :"PROS",
            }
        }
        "prosAccountList"
        {
            "personId" :"6709873933",
            "prospectAccountId" :"0261587703",
            "customerClass" :"BK",
            "accountDivision" :"930",
            "status" :"ACTIVE",
            "setUpDate" :"2024-01-01",
            "currency" :"USD",
            "billCycle" :"ASH3",
            "accountAccessGroup" :"BKUSER",
            "prosAcctCharacteristicList"
            {
                "characteristicValue" :"PROS",
                "effectiveDate" :"2024-01-01",
                "characteristicType" :"C1_F_ANO",
            }
            "prosAcctIdentifierList"
            {
                "accountIdentifierType" :"CCT_NM",
                "isPrimaryId" :"true",
                "accountNumber" :"PROS",
            }
        }
        "prosAccountList"
        {
            "personId" :"6081480244",
            "prospectAccountId" :"0261587703",
            "customerClass" :"BK",
            "accountDivision" :"930",
            "status" :"ACTIVE",
            "setUpDate" :"2024-01-01",
            "currency" :"USD",
            "billCycle" :"ASH3",
            "accountAccessGroup" :"BKUSER",
            "prosAcctCharacteristicList"
            {
                "characteristicValue" :"PROS",
                "effectiveDate" :"2024-01-01",
                "characteristicType" :"C1_F_ANO",
            }
            "prosAcctIdentifierList"
            {
                "accountIdentifierType" :"CCT_NM",
                "isPrimaryId" :"true",
                "accountNumber" :"PROS",
            }
        }
        "prosAccountList"
        {
            "personId" :"3055256440",
            "prospectAccountId" :"0261587703",
            "customerClass" :"BK",
            "accountDivision" :"930",
            "status" :"ACTIVE",
            "setUpDate" :"2024-01-01",
            "currency" :"USD",
            "billCycle" :"ASH3",
            "accountAccessGroup" :"BKUSER",
            "prosAcctCharacteristicList"
            {
                "characteristicValue" :"PROS",
                "effectiveDate" :"2024-01-01",
                "characteristicType" :"C1_F_ANO",
            }
            "prosAcctIdentifierList"
            {
                "accountIdentifierType" :"CCT_NM",
                "isPrimaryId" :"true",
                "accountNumber" :"PROS",
            }
        }
        "prosAccountList"
        {
            "personId" :"3749439310",
            "prospectAccountId" :"0261587703",
            "customerClass" :"BK",
            "accountDivision" :"930",
            "status" :"ACTIVE",
            "setUpDate" :"2024-01-01",
            "currency" :"USD",
            "billCycle" :"ASH3",
            "accountAccessGroup" :"BKUSER",
            "prosAcctCharacteristicList"
            {
                "characteristicValue" :"PROS",
                "effectiveDate" :"2024-01-01",
                "characteristicType" :"C2CNTSER",
            }
            "prosAcctIdentifierList"
            {
                "accountIdentifierType" :"CCT_NM",
                "isPrimaryId" :"true",
                "accountNumber" :"PROS",
            }
        }
        "prosPerCharactersticList"
        {
            "personcharacteristicValue" :"A",
            "personEffectiveDate" :"2011-01-01",
            "personCharType" :"C1CUSTAT",
        }
    }
}
Note: We have given the above request and response samples to illustrate how the attribute value pairs should be structured while sending a prospect update request from the external system. However, you should not seamlessly use this request sample in your environment because the required pre-requisite data may not be available in your environment. In such case, the system will give erroneous results.

Related Topics

For more information on... See...
Prospect update request and response attribute/value pairs in the JSON format Prospect Update Request and Response - Attribute/Value Pairs in the JSON Format