Update User
Update mutable fields on an existing user. Omit fields to leave them unchanged.
Authentication: send the program API key either in the api_key HTTP header or as an api_key JSON body field.
curl --request POST \
--url https://api.sdev.banking.ingopayments.tech/api/v4/user/update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"api_key": "YOUR_API_KEY",
"user_id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
"first_name": "Alex",
"middle_name": "",
"last_name": "Rivera",
"phone_number": "+15555551234",
"city": "Anytown",
"state": "TX",
"country": "US",
"postal_code": "30044",
"date_of_birth": "2000-04-20",
"address_one": "100 Innovation Way",
"address_two": "Suite 100",
"username": "janedoe",
"ssn": "XXXXXXXXX"
}
'{
"status": "success",
"message": "operation completed",
"data": {
"items": [
{
"id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
"uuid": "<string>",
"first_name": "Jane",
"middle_name": "<string>",
"last_name": "Doe",
"email": "jane.doe@example.com",
"phone_number": "+12125551234",
"date_of_birth": "1990-04-15",
"address_one": "<string>",
"address_two": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"postal_code": "<string>",
"ssn_last_4": "6789",
"status": "active",
"kyc_status": "verified",
"created_at": "2026-04-16T12:34:56.000Z",
"updated_at": "2026-04-16T12:34:56.000Z"
}
],
"pagination": {
"page": 1,
"per_page": 25,
"total": 100,
"sort": "created_at:desc",
"search": "jane"
}
}
}Documentation Index
Fetch the complete documentation index at: https://developers.ingopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Program API key identifying your integration. Pass as the api_key HTTP header (preferred) or as an api_key field in the JSON request body. Required on every request in addition to the HMAC Authorization header.
Body
Identifier of the target user. Required when the endpoint operates on a specific user.
"user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef"
Program API key. Accepted either in the api_key HTTP header or as this body field.
First name.
Middle name.
Last name.
Phone number in E.164 format.
"+12125551234"
5-digit US ZIP code.
ISO 3166-1 alpha-2 country code.
ISO 3166-2 two-letter state/region code.
City.
Street address line 1.
Street address line 2.
Chosen username for the user.
Date of birth in YYYY-MM-DD format.
"1990-04-15"
Social security number. Encrypted at rest.
curl --request POST \
--url https://api.sdev.banking.ingopayments.tech/api/v4/user/update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"api_key": "YOUR_API_KEY",
"user_id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
"first_name": "Alex",
"middle_name": "",
"last_name": "Rivera",
"phone_number": "+15555551234",
"city": "Anytown",
"state": "TX",
"country": "US",
"postal_code": "30044",
"date_of_birth": "2000-04-20",
"address_one": "100 Innovation Way",
"address_two": "Suite 100",
"username": "janedoe",
"ssn": "XXXXXXXXX"
}
'{
"status": "success",
"message": "operation completed",
"data": {
"items": [
{
"id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
"uuid": "<string>",
"first_name": "Jane",
"middle_name": "<string>",
"last_name": "Doe",
"email": "jane.doe@example.com",
"phone_number": "+12125551234",
"date_of_birth": "1990-04-15",
"address_one": "<string>",
"address_two": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"postal_code": "<string>",
"ssn_last_4": "6789",
"status": "active",
"kyc_status": "verified",
"created_at": "2026-04-16T12:34:56.000Z",
"updated_at": "2026-04-16T12:34:56.000Z"
}
],
"pagination": {
"page": 1,
"per_page": 25,
"total": 100,
"sort": "created_at:desc",
"search": "jane"
}
}
}