Users

Update Contact Info

Update the authenticated user's full contact information.

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.

<Info>Requests with 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.</Info>

Common Failure Scenarios

  • A required field is missing, or country/mailingCountry is not a two-letter code.
  • The combined firstName and lastName length exceeds 60 characters.
  • The request is sent to a Demo server instead of Live.

Error Messages

errorTextTrigger
Request should be sent to Live serverThe request was sent to a Demo server; contact-info updates are processed on Live only.
Failed to update contact info: <id>. Please retryThe update could not be persisted; retry the request.
Non-empty errorTextThe request failed; the field describes the reason.
post/contactInfo/updatecontactinfo

Request

  • Base URL: https://demo.tradovateapi.com/v1
  • URL: https://demo.tradovateapi.com/v1/contactInfo/updatecontactinfo
  • Auth: HTTP bearer

Request body

userIdinteger required
firstNamestring required
lastNamestring required
streetAddress1string required
streetAddress2string
citystring required
statestring
postCodestring
countrystring required
phonestring required
mailingIsDifferentboolean
mailingStreetAddress1string
mailingStreetAddress2string
mailingCitystring
mailingStatestring
mailingPostCodestring
mailingCountrystring
approvedIdinteger
jointFirstNamestring
jointLastNamestring

Response

UpdateContactInfoResponse

errorTextstring

Non-empty if the request failed

Changes

No recorded changes to this operation across all 1 revision of this API.