Bulk contact import

You'll be directed to the start page of the Contact import tool.

1: Download the CSV example file, the template file will be used to create contacts in your Realtime Register account through our portal.

2: Once the download is completed, open the template file. Once opened, you'll notice example.com is pre-filled in the CSV file to serve as an example on how to submit the required data for a Contact import. By default, the handle, name, addressLine, postalCode, city, country, email & voice fields are required to create a contact using the Contact import bulk tool

Important

Please note that the name field is meant for the name of a natural person. If you wish to import contacts that are for organizations, you submit the name of the CEO/contact persons in the name field and the name of the organization in the organization field

3: We'll go over the available fields in the CSV template and what information in what format needs to be submitted where one by one. Keep in mind that not all fields require input.

Important

Multiple values

In order to use multiple values in your contact import if necessary, you can either user multiple fields in the CSV or separate values using a field separator.

Multiple fields
To use, add a number to the column name and increment for multiple values. For example, you can have columns addressLine1, addressLine2 etc.

Field seperator
Use one of the following field separators to indicate multiple values in a field: | , \n

handle	Provide the contact handle name here

name	Provide the name of the natural person here. Remember, it's best practice to use full names; no abbreviations like 'R.T. Register' are allowed for some registries in the name field

addressLine	Provide the (street)address(es) here

postalCode	Provide the the postalcode here

city	Provide the the city name here

country	Provide the the ISO 3166 country code the person/company resides in here

email	Provide the contact's email address here. Keep in mind, this should be a working email address

voice	Provide the contact's telephone number here in E164a format, for example, if you submit a Dutch phone number, you add; +31.123456789

brand	Provide the brand for the contact here. If this field is left empty, your default brand will be connected to the created contact

organization	Provide the the organization name here if applicable

state	Provide the state here. For some registries (nicIT for .IT domains, for example), the state field is required in the registrant contact to be able to create/transfer in domains

fax	Provide the fax number here in E164a format if applicable. For example, if you submit a Dutch fax number, you add +31.123456789

4: Once you've submitted all the values you wish to define, your template file should look similar like the example below;

5: Upload the CSV template in the bulk Contact import tool and click next

6: On the bulk Contact import overview page, you can map the data that was provided in the CSV before creating the bulk Contact import job. Map the Contact import data as required and click Create job to create the bulk Contact import job

Important

If you have defined multiple values for fields in your CSV, you need to map the multiple values according to the used method in your CSV, otherwise the Contact import tool will not recognize the values. Below you'll find an example on how to map multiple fields (addressLine1, addressLine2 etc.) and how to map a field separator ( | , \n )

Using multiple fields

When using multiple fields, you need to map the multiple fields in order for the Contact import tool to recognize the multiple fields in the CSV you've uploaded. In the example below, two address fields were provided in the CSV file and mapped to be recognized as addressLine1 and addressLine2.

Using a field separator

Select the fields separator used in your CSV. In the example below, a pipe was used to separate the addressLine values in the addressLine field of the CSV and mapped to Street 1 and Street 2.

7: On the job detail page, an overview of all the jobs is available and changes can still be made. If all the data is mapped correctly, you can run all tasks. If you wish to run a few separate tasks prior to running all tasks, you can select a selection of tasks you wish to run and run them first, instead of running all tasks in one go in your first attempt. An option to delete tasks is available as well

8: Once the tasks have completed/failed, they will be detailed on the job detail overview. By clicking on the completed/failed tiles, you'll be able to check the detail overview of the tasks that have completed/failed

Important

If you run into any failed tasks, just click the failed task tile and you can edit any failed contact imports to correct the errors (error information is displayed on screen) and retry the failed tasks.

9: You've now successfully completed a bulk Contact import in our portal. If you run into any errors you're not able to resolve yourself, be sure to contact our support department, provide the job name and tasks you're having issues with