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
| errorText | Trigger |
|---|---|
| Request should be sent to Live server | The request was sent to a Demo server; contact-info updates are processed on Live only. |
| Failed to update contact info: <id>. Please retry | The update could not be persisted; retry the request. |
| Non-empty errorText | The request failed; the field describes the reason. |
Request
- Base URL: https://demo.tradovateapi.com/v1
- URL: https://demo.tradovateapi.com/v1/contactInfo/updatecontactinfo
- Auth: HTTP bearer
Request body
Response
UpdateContactInfoResponse
Changes
No recorded changes to this operation across all 1 revision of this API.