Table of contents

Description

The contact create command allows you to create a new contact. By default, we check if a contact with the exact same data exists. If true, no new contact is created and the identical contact is used. If this behaviour is not desired, it can be deactivated with the general contact extensions.

Extensions

For certain TLDs additional contact information is required which is not defined in the RFC 5733 standard. For this purpose, the following EPP extensions have been defined.

Note

  • The contact:id that is used is generated by us, the given contact:id is ignored.
  • Disclose - is only used for telephone, fax and email together if one is set it applies for all three.

  • An AuthInfo can not be set for a contact.

XML example

Request
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <command>
        <create>
            <contact:create xmlns:contact="urn:ietf:params:xml:ns:contact-1.0">
                <contact:postalInfo type="loc">
                    <contact:name>John Doe</contact:name>
                    <contact:org>Example Inc.</contact:org>
                    <contact:addr>
                        <contact:street>123 Example Street</contact:street>
                        <contact:street>Suite 100</contact:street>
                        <contact:city>Anytown</contact:city>
                        <contact:sp>VA</contact:sp>
                        <contact:pc>20166-6503</contact:pc>
                        <contact:cc>US</contact:cc>
                    </contact:addr>
                </contact:postalInfo>
                <contact:voice x="1234">+1.7035555555</contact:voice>
                <contact:fax>+1.7035555556</contact:fax>
                <contact:email>john.doe@exmaple.com</contact:email>
                <contact:disclose flag="0">
                    <contact:voice />
                    <contact:email />
                </contact:disclose>
            </contact:create>
        </create>
        <extension>
            <domainrobot:contact xmlns:domainrobot="urn:org:domainrobot:ns:ext-1.0">
                <domainrobot:type>PERSON</domainrobot:type>
                <domainrobot:companynumber>123456789</domainrobot:companynumber>
                <domainrobot:gender>FEMALE</domainrobot:gender>
                <domainrobot:trademark>
                    <domainrobot:name>Test Trademark</domainrobot:name>
                    <domainrobot:number>123456789</domainrobot:number>
                </domainrobot:trademark>
                <domainrobot:identity>
                    <domainrobot:number>123456789</domainrobot:number>
                    <domainrobot:authority>ID Authority Fake City</domainrobot:authority>
                    <domainrobot:dateOfIssue>1983-01-30T23:00:00.000Z</domainrobot:dateOfIssue>
                    <domainrobot:validTill>1983-01-30T23:00:00.000Z</domainrobot:validTill>
                </domainrobot:identity>
                <domainrobot:birth>
                    <domainrobot:country>DE</domainrobot:country>
                    <domainrobot:day>1983-01-30T23:00:00.000Z</domainrobot:day>
                    <domainrobot:pcode>12345</domainrobot:pcode>
                    <domainrobot:place>Fake City</domainrobot:place>
                </domainrobot:birth>
            </domainrobot:contact>
            <xxx:contact xmlns:xxx="urn:org:domainrobot:ns:contact:xxx-1.0">
                <xxx:membershipId>123456789</xxx:membershipId>
                <xxx:nonResolverDomain>1</xxx:nonResolverDomain>
            </xxx:contact>
            <uk:contact xmlns:uk="urn:org:domainrobot:ns:contact:uk-1.0">
                <uk:type>LTD</uk:type>
            </uk:contact>
            <jobs:contact xmlns:jobs="urn:org:domainrobot:ns:contact:jobs-1.0">
                <jobs:adminType>0</jobs:adminType>
                <jobs:contactTitle>Dr.</jobs:contactTitle>
                <jobs:hrMember>0</jobs:hrMember>
                <jobs:website>mywebsite.com</jobs:website>
                <jobs:jobsIndustryClass>25</jobs:jobsIndustryClass>
            </jobs:contact>
            <hk:contact xmlns:hk="urn:org:domainrobot:ns:contact:hk-1.0">
                <hk:documentType>OTHID</hk:documentType>
                <hk:others>STUDENTCARD</hk:others>
                <hk:documentNumber>123BR456</hk:documentNumber>
                <hk:documentOrigin>DE</hk:documentOrigin>
                <hk:above18>0</hk:above18>
            </hk:contact>
            <cat:contact xmlns:cat="urn:org:domainrobot:ns:contact:cat-1.0">
                <cat:intendedUse>1</cat:intendedUse>
            </cat:contact>
            <au:contact xmlns:au="urn:org:domainrobot:ns:contact:au-1.0">
                <au:eligibilityId>acn</au:eligibilityId>
                <au:eligibilityIdType>NSW BN</au:eligibilityIdType>
                <au:eligibilityName>Charity</au:eligibilityName>
                <au:eligibilityType>Company</au:eligibilityType>
                <au:registrantIdType>ABN</au:registrantIdType>
                <au:registrantName>Jon Doe</au:registrantName>
            </au:contact>
            <aero:contact xmlns:aero="urn:org:domainrobot:ns:contact:aero-1.0">
                <aero:ensAuthId>123456789</aero:ensAuthId>
                <aero:ensKey>abc123def456ghi789</aero:ensKey>
            </aero:contact>
            <bank:contact xmlns:bank="urn:org:domainrobot:ns:contact:bank-1.0">
                <bank:governmentRegulatoryAuthorityName>Jon Doe Authority</bank:governmentRegulatoryAuthorityName>
                    <bank:HumanResourceMail>jon.doe@example.com</bank:HumanResourceMail>
                <bank:HumanResourceName >Jon Doe</bank:HumanResourceName >
                <bank:HumanResourcePhone>+49-0-0</bank:HumanResourcePhone>
                <bank:RegulatoryIdNumber>123456789</bank:RegulatoryIdNumber>
            </bank:contact>
            <barcelona:contact xmlns:barcelona="urn:org:domainrobot:ns:contact:barcelona-1.0">
                <barcelona:intendedUse>E-Commerce Shop</barcelona:intendedUse>
            </barcelona:contact>
            <ca:contact xmlns:ca="urn:org:domainrobot:ns:contact:ca-1.0">
                <ca:cpr>CCT</ca:cpr>
                <ca:officialRepresentative>Jon Doe</ca:officialRepresentative>
                <ca:trusteePercentage>10.0</ca:trusteePercentage>
            </ca:contact>
            <it:contact xmlns:it="urn:org:domainrobot:ns:contact:it-1.0">
                <it:entityType>1</it:entityType>
            </it:contact>
            <jp:contact xmlns:jp="urn:org:domainrobot:ns:contact:jp-1.0">
                <jp:address1B64>Street in Japan 1</jp:address1B64>
                <jp:address2B64>Street in Japan 2</jp:address2B64>
                <jp:address3B64>Street in Japan 3</jp:address3B64>
                <jp:fnameB64>Hideki</jp:fnameB64>
                <jp:lnameB64>Koshima</jp:lnameB64>
                <jp:organizationB64>Koshima Incorporated</jp:organizationB64>
            </jp:contact>
            <ro:contact xmlns:ro="urn:org:domainrobot:ns:contact:ro-1.0">
                <ro:personType>p</ro:personType>
            </ro:contact>
            <ru:contact xmlns:ru="urn:org:domainrobot:ns:contact:ru-1.0">
                <ru:taxpayerIdentificationNumber>123456789</ru:taxpayerIdentificationNumber>
                <ru:territoryLinkedTaxpayerNumber>987654321</ru:territoryLinkedTaxpayerNumber>
            </ru:contact>
            <swiss:contact xmlns:swiss="urn:org:domainrobot:ns:contact:swiss-1.0">
                <swiss:enterpriseId>CHE-111.222.333</swiss:enterpriseId>
                <swiss:intendedUse>E-Commerce Shop</swiss:intendedUse>
            </swiss:contact>
        </extension>
        <clTRID>ABC-12345</clTRID>
    </command>
</epp>
Response
<epp xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" xmlns:domainrobot="urn:org:domainrobot:ns:ext-1.0" xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" xmlns:pro="urn:org:domainrobot:ns:contact:pro-1.0" xmlns:ro="urn:org:domainrobot:ns:contact:ro-1.0" xmlns:xxx="urn:org:domainrobot:ns:contact:xxx-1.0" xmlns:ca="urn:org:domainrobot:ns:contact:ca-1.0" xmlns:cat="urn:org:domainrobot:ns:contact:cat-1.0" xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:jobs="urn:org:domainrobot:ns:contact:jobs-1.0" xmlns:rgp="urn:ietf:params:xml:ns:rgp-1.0" xmlns:aero="urn:org:domainrobot:ns:contact:aero-1.0" xmlns:host="urn:ietf:params:xml:ns:host-1.0" xmlns:hk="urn:org:domainrobot:ns:contact:hk-1.0" xmlns:bank="urn:org:domainrobot:ns:contact:bank-1.0" xmlns:it="urn:org:domainrobot:ns:contact:it-1.0" xmlns:barcelona="urn:org:domainrobot:ns:contact:barcelona-1.0" xmlns:au="urn:org:domainrobot:ns:contact:au-1.0" xmlns:uk="urn:org:domainrobot:ns:contact:uk-1.0" xmlns:swiss="urn:org:domainrobot:ns:contact:swiss-1.0" xmlns:ru="urn:org:domainrobot:ns:contact:ru-1.0">
	<response>
		<result code="1000">
			<msg lang="en">Command completed successfully</msg>
		</result>
		<resData>
			<contact:creData>
				<contact:id>23022508</contact:id>
				<contact:crDate>2017-07-04T12:07:16.000Z</contact:crDate>
			</contact:creData>
		</resData>
		<trID>
			<clTRID>ABC-12345</clTRID>
			<svTRID>DEF-12345</svTRID>
		</trID>
	</response>
</epp>