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

Used to split a contact in two separate contacts. Main purpose is to enable updates to a contact when a registry does not allow a specific update without having to update all domains using the contact. In this case the "split" can be used to separate the prohibiting registries to a new contact, enabling the existing contact to be updated.

The new contact will have the same contact details, validations and evidences are copied. Additional properties will be moved to the new contact for the selected registries, others will stay at the old contact.

All domains from the selected registries, using the old contact, will be updated to use the new contact. No actual change is made at the registry.

This method can also be used to duplicate a contact while retaining it's validations and evidences.

  • POSTMethod
  • /v2/customers/customer/contacts/handle/splitURL
  • application/jsonContent-Type
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
Name Type Required / Optional Description Restrictions
newHandle String Required The handle for the new contact
  • Regular expression: [a-zA-Z0-9\-_@\.]+
  • Minimum length: 3
  • Maximum length: 40
registries List <String> Optional List of registries to move to the new contact

Successful request

  • 201 CreatedHTTP Status
  • application/jsonContent-Type

Failed requests

Generic errors can be expected.

The handle of the customer
The contact handle
The handle for the new contact
List of registries to move to the new contact

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

{}