Update Contact Info
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
Response
Non-empty if the request failed
Bearer authentication of the form Bearer <token>, where token is your auth token.
Non-empty if the request failed
Available to: All authenticated users
Environments: Live <!— handler gate: returns “Request should be sent to Live server” on Demo —>
Rate Limit: No endpoint-specific limit
Replaces the contact information on file for the user identified by userId. The request carries the full contact record: required firstName, lastName, streetAddress1, city, country (two-letter code), and phone, plus optional fields including streetAddress2, state, postCode, a separate mailing address (set mailingIsDifferent and the mailing* fields), and joint-account names (jointFirstName, jointLastName).
Whether the change applies immediately or is held for review depends on the account. For users whose contact changes require approval and who hold one or more accounts, the update is recorded as a pending change and takes effect only after it is approved. Otherwise the update is applied directly. On success the response returns the resulting contactInfo.
This endpoint operates against Live. On Demo it returns an error indicating the request must be sent to the Live server.
To change only the name, country, and phone without sending the full address record, use updateContactInfoName.
firstName and lastName fields exceeding a combined 60 characters are rejected, despite each field individually allowing up to 64 characters. The same limit applies to jointFirstName and jointLastName.Common Failure Scenarios
country/mailingCountry is not a two-letter code.firstName and lastName length exceeds 60 characters.Error Messages