POST /user/update
This endpoint is used to update user information associated with an existing user_token
. It can also be used to enable an existing user_token
for use with Consumer Reports by Plaid Check, by adding a consumer_report_user_identity
object to the user. Plaid Check Consumer Reports can only be created for US-based users; the user's address country must be US
.
Servers
- https://production.plaid.com
- https://sandbox.plaid.com
Request headers
Name | Type | Required | Description |
---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
Name | Type | Required | Description |
---|---|---|---|
user_token |
String | Yes |
The user token associated with the User data is being requested for. |
client_id |
String | No |
Your Plaid API |
secret |
String | No |
Your Plaid API |
consumer_report_user_identity |
Object | Yes |
To create a Plaid Check Consumer Report for a user, this field must be present on the user token. If this field is not provided during user token creation, you can add it to the user later by calling |
consumer_report_user_identity.date_of_birth |
String | Yes |
To be provided in the format "yyyy-mm-dd". This field is required for all Plaid Check customers. |
consumer_report_user_identity.primary_address |
Object | Yes |
Data about the components comprising an address. |
consumer_report_user_identity.primary_address.region |
String | Yes |
The region or state. In API versions 2018-05-22 and earlier, this field is called |
consumer_report_user_identity.primary_address.postal_code |
String | Yes |
The postal code. In API versions 2018-05-22 and earlier, this field is called |
consumer_report_user_identity.primary_address.country |
String | Yes |
The ISO 3166-1 alpha-2 country code |
consumer_report_user_identity.primary_address.street |
String | Yes |
The full street address
Example: |
consumer_report_user_identity.primary_address.city |
String | Yes |
The full city name |
consumer_report_user_identity.last_name |
String | Yes |
The user's last name |
consumer_report_user_identity.ssn_last_4 |
String | No |
The last 4 digits of the user's social security number. |
consumer_report_user_identity.phone_numbers[] |
Array | Yes |
The user's phone number, in E.164 format: +{countrycode}{number}. For example: "+14157452130". Phone numbers provided in other formats will be parsed on a best-effort basis. Phone number input is validated against valid number ranges; number strings that do not match a real-world phone numbering scheme may cause the request to fail, even in the Sandbox test environment. |
consumer_report_user_identity.first_name |
String | Yes |
The user's first name |
consumer_report_user_identity.emails[] |
Array | Yes |
The user's emails |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.