Update a customer

See customer object definition for parameter details.

🚧

As a fraud prevention mechanism very few properties can be updated via API if your program uses Helix KYC/IDV. The list of properties will vary based on your specific program settings. Please reach out to your relationship manager if you have any questions about enabling certain property updates.

Error Codes

Click to expand
CodeMessage (en-US)Notes
1-60000Any "Common Error Code" may occur.See Common Error Codes
60001Customer id [NULL] is invalid.
60006businessNameOnCard {0} is restricted to 26 characters.
60007businessNameOnCard {0} contains invalid characters. Refer to API documentation for valid characters.
60263PreferredName ‘{0}’ is restricted to 21 characters
60264PreferredName ‘{0}’ has some unsupported characters
60265PreferredName not enabled on program
60266preferredName is required when usePreferredNameOnCard is passed as true
60301Birth Date is invalid. Please enter a valid date after 01/01/1900.
60302Gender is invalid. Valid values are: 'M', 'F', and 'U'.
60303Tag '{0}' is already associated with a different customer.
60304Invalid email address
60305Invalid industryClassificationCodeId '{id}'
60306Your program settings do not allow for firstName or lastName to be updated via API.
60307Your program settings do not allow for emailAddress to be updated via API.
60308Your program settings do not allow for residence address to be updated via API.
60350Only three addresses are allowed -- one for each valid type of Residence, Mailing, or Prior.
60351Only three phones are allowed -- one for each valid type of Home, Mobile, or Office.
60352Invalid foreignDocumentType
60353Foreign document values are not allowed by program
60354foreignDocumentType required foreignDocumentNumber on the the customer record
60355foreignDocumentCountryCode required a foreignDocumentNumber on the customer record
60356foreignDocumentExpirationDate requires a foreignDocumentNumber on the customer record
60450Updating any properties that are used during the ID Verification process is not allowed. These properties include firstName, middleName, lastName, birthDate, taxId, emailAddress, license information, passport information, and Residence address informationOnly applicable if your program uses Helix's KYC/Fraud/OFAC checks for customer verification
66801Invalid Phone Type. Valid values are: 'Home', 'Mobile', 'Office'.
66802Phone Number is a required field.
66901Invalid Address Type. Valid values are: Mailing, Residence, Prior.
66902Address Line 1 is a required field.
66903City is a required field.
66904State is a required field.
66905Postal Code is a required field.
66906Country is a required field.
66907Residential Addresses can not contain a PO Box.
66908DPS Clients Only: Address lines must not exceed 76 characters.
194102Your program settings do not allow for updating of businessLegalName.
194103"Your program settings do not allow for updating of dba.
194104Your program settings do not allow for updating of legalEntityType.
194105Your program settings do not allow for updating of isTaxExempt.
194106Your program settings do not allow for updating of taxId.
194107Your program settings do not allow for updating of taxIdType.
194108Your program settings do not allow for updating of PrimaryBusiness addressType.
194109Your program settings do not allow for updating of Mailing addressType.
194115Preferred Name is not allowed for businesses
Language
Authorization
Basic
base64
:
URL
Click Try It! to start a request and see the response here!