---
title: "Contact update"
url: "https://help.internetx.com/en/api/core-contact-update/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Tasks > Contact tasks"
updated: "2026-04-09"
---

# Contact update

## Function

The _ContactUpdate_ task updates a contact.  

Domain contact data that is not sent with the _ContactUpdate_ request will be deleted. To avoid the deletion of data, you must always send all data to the system when updating contacts. In advance you can enquire the data with a ContactInfo request.

_Example:  
When you send a ContactUpdate request to the system without a fax number, the fax number is deleted from the system.  
_

Data Validation

The address data is validated when the contact is updated and address data has changed. The validation results in values from A to E. If the validation result is D or E, the contact create fails with the error code . It is possible to ignore the validation result and create the contact anyway.  
To do this, the key `ignoreAddressQuality` can be specified using the query parameter `keys[]`. If the quality is D or E, you can trigger another check with the parameter `recheckAddressQuality`.  
If the quality is still D or E, the update will fail with the error code `EF01152`.  
If the quality is improved to A, B or C, the update will be successful.

## Description

Route: PUT /contact/{id}

```
{
   "alias": "johndoe",
   "type": "PERSON",
   "organization": "Company",
   "title": "Dr.",
   "city": "example city",
   "country": "US",
   "state": "",
   "email": "johndoe@example.com",
   "fname": "john",
   "lname": "doe",
   "address": [
      "555 example street"
   ],
   "pcode": "54321",
   "phone": "+49-321-54321",
   "fax": "+49-321-54321",
   "general": {
      "identification": {
         "number": "number",
         "authority": "government office",
         "dateOfIssue": "2017-03-01T14:31:33.5660555Z",
         "validTill": "2022-03-01T14:31:33.5660555Z"
      }
   }
}
```

```
{
    "stid": "20190628-app3-dev-11597",
    "status": {
        "code": "S0302",
        "text": "Domain contact has been updated successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Contact",
        "value": "23142212"
    }
}
```

Task code: 0302  
Uses [Contact](/en/api/core-contact-object/) object  

```
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0302</code>
		<handle>
			<alias>johndoe</alias>
			<id>1234567</id>
			<type>PERSON</type>
			<fname>john</fname>
			<lname>doe</lname>
			<title></title>
			<organization>PDA</organization>
			<address>example street</address>
			<pcode>12345</pcode>
			<city>example city</city>
			<state></state>
			<country>US</country>
			<phone>+1-12345-12345</phone>
			<fax>+1-12345-12345</fax>
			<email>johndoe@example.com</email>
			<protection>B</protection>
			<nic_ref>de</nic_ref>
			<nic_ref>com</nic_ref>
			<nic_ref>net</nic_ref>
			<remarks></remarks>
			<extension>
				<gender></gender>
				<idnumber></idnumber>
				<vatnumber></vatnumber>
				<trademark_name></trademark_name>
				<trademark_number></trademark_number>
				<trademark_country></trademark_country>
				<trademark_regdate></trademark_regdate>
				<trademark_appdate></trademark_appdate>
				<companynumber></companynumber>
				<birthday></birthday>
				<birthplace></birthplace>
				<birthcountry></birthcountry>
			</extension>
			<confirm_owner_consent>1</confirm_owner_consent>
		</handle>
		<reply_to>customer@example.com</reply_to>
	</task>
</request>
```

```
<response>
	<result>
		<data/>
		<status>
			<code>S0302</code>
			<text>Domain contact has been updated successfully.</text>
			<type>success</type>
			<object>
				<type>user</type>
				<value>customer</value>
			</object>
		</status>
	</result>
	<stid>20160615-app4-151275</stid>
</response>
```