User data change
There are various reasons why a user might request a data change, for example, moving to a new city, getting married and thus changing their name or adding a nationality. In order to keep the user information synchronised and up-to-date, the Investment API allows data changes by sending appropriate requests.
This guide outlines how to change data about a user and which proof documents have to be provided.
How user data changes work
In the request body, you specify which fields you intend to change.
Depending on the respective fields to be changed, Upvest may require a proof for changing the user information. There are four different categories available that require different proof documents.
The following proof documents are accepted:
Category | User fields | Required proof documents |
---|---|---|
Name change | first_name & last_name |
|
Nationality change | nationalities (array) |
|
Address change | address (object) |
|
Other | salutation , title , email , phone_number , birth_name , postal_address |
|
Prerequisites
Before you can change data of a user you must have created one. You can find out how to do this in our User onboarding guide.
Changing user data
To change data of a user, send
POST /users/{user_id}/data_change_requests
Example request
1. Changing the user's name
Example request
2. Changing the user's address
Example request
3. Changing the user's email
Example request
After you requested a data change Upvest will download a potential proof for the data change, adjust the user information and then send a data change passed webhook. If the data change failed, e.g. due to problems with the proof files, you will receive a data change failed webhook.
Next steps
Since a change to user data can made at any point in the user's lifecycle in the Investment API, a next step could be to create an account group or place an order. You can see the updated data when retrieving a report.
Was this page helpful?