--- title: "Add a contact detail" description: "Add contact details to a financial or shareholder contact for a merchant account." url: "https://docs.adyen.com/account-management-api/manage-contact-details/addcontactdetail" source_url: "https://docs.adyen.com/account-management-api/manage-contact-details/addcontactdetail.md" canonical: "https://docs.adyen.com/account-management-api/manage-contact-details/addcontactdetail" last_modified: "2026-05-25T12:55:01+02:00" language: "en" --- # Add a contact detail Add contact details to a financial or shareholder contact for a merchant account. [View source](/account-management-api/manage-contact-details/addcontactdetail.md) ## Request parameters To send additional details in the record of the specified contact type associated with a merchant account, make a POST `/addContactDetail` request 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 | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | 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 | ![-x-](/user/data/smileys/emoji/x.png "-x-") | A container object for personal information details.- `dateOfBirth` - `idNumber` - `nationality` | | | | \|-`dateOfBirth` | class | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The shopper's date of birth.Format: [ISO-8601](https://www.w3.org/TR/NOTE-datetime); example: YYYY-MM-DD | | | | \|-`idNumber` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | 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 | ![-x-](/user/data/smileys/emoji/x.png "-x-") | A container object for telephone details.This field holds the following child element(s):- `phoneCountryCode` - `phoneNumber` - `phoneType` | | | | \|-`phoneCountryCode` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | 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 | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Telephone number, without the country code. | | | | \|-`phoneType` | enum | ![-x-](/user/data/smileys/emoji/x.png "-x-") | 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":"1", "postalCode":"1111", "stateOrProvince":"AA", "street":"Erstestraat" }, "email":"john.doe@testshop.nl", "name":{ "firstName":"John", "lastName":"Doe" }, "personalData":{ "dateOfBirth":"1920-02-20", "idNumber":"NL987654321", "nationality":"NL" }, "phoneNumber":{ "phoneCountryCode":"NL", "phoneNumber":"11 22 33 44", "phoneType":"Landline" }, "webAddress":"http:\/\/testshop.nl" }, "contactType":"shareHolder4", "merchantCode":"TestMerchant" } ``` #### Soap ```xml
Amsterdam NL 1 1111 AA Erstestraat
john.doe@testshop.nl John Doe 1920-02-20 NL NL987654321 NL 11 22 33 44 Landline http://testshop.nl shareHolder4 TestMerchant ``` ### Response #### JSON ```json { "pspReference":"9914526964210620" } ``` #### Soap ```xml 9914526964210620 ``` ### Response in case of an error or warning #### JSON ```json { "pspReference":"9914140680120319", "warnings":{ "string":"contact.webAddress is not required for contactType financialContact, ignoring" } } ``` #### Soap ```xml 9914140680120319 contact.webAddress is not required for contactType financialContact, ignoring ```