Need help? Call Live Support at +31 (0) 38 453 07 59

Attention! You're currently using the OT&E environment.

Update Contact

Used to update a contact. Only specified fields are updated, to remove an optional field specify it as empty.

  • POSTMethod
  • /v2/customers/customer/contacts/handle/updateURL
  • application/jsonContent-Type
URL fields
Name Type Description Restrictions
customer String The handle of the customer
  • Regular expression: [a-zA-Z0-9\-_@\.]+
  • Minimum length: 3
  • Maximum length: 40
handle String The contact handle
  • Regular expression: [a-zA-Z0-9\-_@\.]+
  • Minimum length: 3
  • Maximum length: 40
Request content fields
Name Type Required / Optional Description Restrictions
brand String Optional The brand to link the contact to
  • Regular expression: [a-zA-Z0-9\-_@\.]+
  • Minimum length: 3
  • Maximum length: 40
organization String Optional The name of the organization
  • Maximum length: 255
name String Optional The name of the person
  • Minimum length: 1
  • Maximum length: 255
addressLine List <String> Optional The address lines
  • Minimum number of items: 1
  • Maximum number of items: 3
  • Minimum length: 1
  • Maximum length: 255
postalCode String Optional Postal code
  • Minimum length: 1
  • Maximum length: 16
city String Optional The city
  • Minimum length: 1
  • Maximum length: 255
state String Optional The state
  • Maximum length: 255
country String Optional The ISO 3166-1 alpha2 country code
  • Minimum length: 2
  • Maximum length: 2
email String Optional The email address
  • Regular expression: (?=.{1,64}@)[a-z0-9_\-+]+(?:\.[a-z0-9_\-+]+)*@(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])
  • Minimum length: 6
  • Maximum length: 255
voice String Optional The voice telephone number. E164a format, eg: +31.384530759
  • Regular expression: \+[0-9]{1,3}\.[0-9]{1,14}
  • Minimum length: 4
  • Maximum length: 17
fax String Optional The fax telephone number. E164a format, eg: +31.384530759
  • Regular expression: (\+[0-9]{1,3}\.[0-9]{1,14})?
  • Maximum length: 17
designatedAgent Enum Optional Indicates for whom you are acting as a designated agent. If a registry does not allow you to be designated agent or interaction with the registrant is still required this parameter is silently ignored. To use this field with any other value then "NONE" the requesting user must have the "DESIGNATED_AGENT" permission.

Possible values:

  • NONE
  • OLD
  • NEW
  • BOTH

Successful request

Contact has been updated successfully
  • 200 OKHTTP Status
  • application/jsonContent-Type
Contact update has been requested successfully, you will be notified with the final result
  • 202 AcceptedHTTP Status
  • application/jsonContent-Type

Failed requests

Besides the generic errors these specific error responses can be expected.

Error responses
Type Status Description
ContactUpdateValidationError 400 Bad Request Contact update is not allowed by constrains laid down by one or more providers using the contact.
URL fields
The handle of the customer
The contact handle
Request parameters
The brand to link the contact to

Specify as empty string: The name of the organization
The name of the person
The address lines
Postal code
The city

Specify as empty string: The state
The ISO 3166-1 alpha2 country code
The email address
The voice telephone number. E164a format, eg: +31.384530759

Specify as empty string: The fax telephone number. E164a format, eg: +31.384530759
Indicates for whom you are acting as a designated agent. If a registry does not allow you to be designated agent or interaction with the registrant is still required this parameter is silently ignored. To use this field with any other value then "NONE" the requesting user must have the "DESIGNATED_AGENT" permission.
Request

POST /v2/customers/customer/contacts/handle/update
Content-Type: application/json 

{}
Response