--- title: "Update a contact detail" description: "Update a financial or shareholder contact detail for a merchant account." url: "https://docs.adyen.com/account-management-api/manage-contact-details/updatecontactdetail" source_url: "https://docs.adyen.com/account-management-api/manage-contact-details/updatecontactdetail.md" canonical: "https://docs.adyen.com/account-management-api/manage-contact-details/updatecontactdetail" last_modified: "2026-05-24T12:54:32+02:00" language: "en" --- # Update a contact detail Update a financial or shareholder contact detail for a merchant account. [View source](/account-management-api/manage-contact-details/updatecontactdetail.md) This call does not support partial updates. If an error occurs during an update: * No changes are applied. * Current data is kept. * The entire update fails. ## Request parameters To update contact details for the specified contact type associated with a merchant account, make a POST `/updateContactDetail` specifying: | Name | | | Type | Required | Description | | -------------- | -------------------- | ---------------------- | ------ | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `contactType` | | | enum | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The type of contact whose details you want to retrieve. Allowed values:- `financialContact` - `shareHolder1` - `shareHolder2` - `shareHolder3` - `shareHolder4` | | `merchantCode` | | | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A merchant code string holds a value to identify a merchant.Format:- Either: `MerchantAccount.Merchant_Code` - Or: `Merchant_Code` | | `contact` | | | class | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A container object for contact type dataThis field holds the following child element(s):- `address` - `name` - `personalData` - `PhoneNumber` - `fullPhoneNumber` - `email` - `webAddress` | | | \|-`fullPhoneNumber` | | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Complete telephone number, i.e. *country code + area code + phone number*, represented as one string. For example: *0031 6 11 22 33 44*; *+316/1122-3344*; *(0031) 611223344.*It is handled as a `Landline` phone type. Max. length: 14 chars. | | | \|-`email` | | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The email address associated with the user account. | | | \|-`webAddress` | | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Web address of the contact. | | | \|-`address` | | class | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A container object for address details.This field holds the following child element(s):- `city` - `country` - `houseNumberOrName` - `postalCode` - `stateOrProvince` - `street` | | | | \|-`city` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The city the contact operates from. | | | | \|-`country` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The country the contact operates from.The `country` value format needs to adhere to the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) standard. An invalid country code results in a transaction/request rejection. You can [look up country codes](https://www.iso.org/obp/ui/) on the ISO website. | | | | \|-`houseNumberOrName` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | House number or name of the building the contact operates from. | | | | \|-`postalCode` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ZIP code.Character limitations:- US ZIP code: max. 5 chars. - Any other country/region: max. 10 chars. | | | | \|-`stateOrProvince` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | State, region or province the contact operates from. | | | | \|-`street` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Street address. | | | \|-`name` | | class | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A container object for personal data- `firstName` - `lastName` | | | | \|-`firstName` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The first name/given name of the user.- Max. length: 80 characters | | | | \|-`lastName` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The last name/family name of the user.- Max. length: 80 characters | | | `\|-personalData` | | class | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A container object for personal information details.- `dateOfBirth` - `idNumber` - `nationality` | | | | \|-`dateOfBirth` | class | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The shopper's date of birth.Format: [ISO-8601](https://www.w3.org/TR/NOTE-datetime); example: YYYY-MM-DD | | | | \|-`idNumber` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A unique identifier for the contact type. | | | | \|-`nationality` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Nationality of the contact.The `country` value format needs to adhere to the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) standard. An invalid country code results in a transaction/request rejection. You can [look up country codes](https://www.iso.org/obp/ui/) on the ISO website.  | | | \|-`PhoneNumber` | | class | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A container object for telephone details.This field holds the following child element(s):- `phoneCountryCode` - `phoneNumber` - `phoneType` | | | | \|-`phoneCountryCode` | String | :![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The country the phone line operates from.The `country` value format needs to adhere to the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) standard. An invalid country code results in a transaction/request rejection. You can [look up country codes](https://www.iso.org/obp/ui/) on the ISO website. | | | | \|-`phoneNumber` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Telephone number, without the country code. | | | | \|-`phoneType` | enum | :![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Telephone line type. Allowed values:- `Landline` - `Mobile` - `SIP` - `Fax` | ## Response parameters If there are no errors in the request, the call returns a `pspReference.`If any issues occur during the process, the call returns one or more warning or error messages. | Name | Type | Returned by default | Description | | -------------- | ------ | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | `pspReference` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A reference to uniquely identify the request. | | `warnings` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | List containing one or more warning messages. Returned when the request is not correctly processed. | | `errors` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | List containing one or more error messages. Returned when the request fails. | ## Examples ### Request #### JSON ```json  { "contact":{ "address":{ "city":"Amsterdam", "country":"NL", "houseNumberOrName":"2", "postalCode":"1111", "stateOrProvince":"AA", "street":"Erstestraat" }, "email":"johanna.van.doe@testshop.nl", "name":{ "firstName":"Johanna", "infix":"van", "lastName":"Doe" }, "personalData":{ "dateOfBirth":"1948-08-14", "idNumber":"NL2227779", "nationality":"PL" }, "phoneNumber":{ "phoneCountryCode":"NL", "phoneNumber":"11 22 33 44", "phoneType":"Landline" }, "webAddress":"http:\/\/testshop.nl" }, "contactType":"financialContact", "merchantCode":"TestMerchant" } ``` #### Soap ```xml johanna.van.doe@testshop.nl Johanna van Doe
Amsterdam NL 2 1111 AA Erstestraat
1948-08-14 NL2227779 PL NL 11 22 33 44 Landline http://testshop.nl financialContact TestMerchant ``` ### Response in case of an error #### JSON ```json { "errors":[ "8_088 contactType 'financialContact' is not yet configured, cannot update" ], "pspReference":"9914140685310352" } ``` #### Soap ```xml 9914140685310352 8_088 contactType 'financialContact' is not yet configured, cannot update ```