Metaregistrar EPP documentation

All domain commands: (check) (create) (delete) (info) (modify) (transfer) (renew) (undelete) (privacy) (autorenew)

Domain create

To create a domain you need to use the domain:create command. This has a number of sub elements. All of these can be found in the RFC. An example command to register a .com domain with two nameservers. Where the registrant and the three contacts(admin,tech,billing are all the same contact. Please see the contact documentation for contacts.

Please note that the hostnames for the nameservers need have been created on the .nl registry if the nameservers addresses also end in .nl otherwise the domain create will fail. The contacts need to exist within your account.

Example Create request

<?xml version="1.0" encoding="UTF-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <command> <create> <domain:create> <domain:name>docu-test-case.nl</domain:name> <domain:ns> <domain:hostObj>ns1.metaregistrar.com</domain:hostObj> <domain:hostObj>ns2.metaregistrar.com</domain:hostObj> </domain:ns> <domain:registrant>RP012rfX8Wa3dE9u4Nu59g6J</domain:registrant> <domain:contact type="admin">RP012rfX8Wa3dE9u4Nu59g6J</domain:contact> <domain:contact type="tech">RP012rfX8Wa3dE9u4Nu59g6J</domain:contact> <domain:contact type="billing">RP012rfX8Wa3dE9u4Nu59g6J</domain:contact> <domain:authInfo> <domain:pw>abded</domain:pw> </domain:authInfo> </domain:create> </create> <clTRID>57cff5b3a60a7</clTRID> </command> </epp>

Example Response

The success reponse contains the domain name and date of creation, but also the Expiration Date (exDate) of the domainname. This fields is important for your records, because it indicates when the domaain name must be renewed if you do not make use of the auto-renew feature of Metaregistrar.

<?xml version="1.0" encoding="UTF-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" xmlns:host="urn:ietf:params:xml:ns:host-1.0" xmlns:ext="http://www.metaregistrar.com/epp/ext-1.0" xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1"> <response> <result code="1000"> <msg>Command completed successfully</msg> </result> <resData> <domain:creData> <domain:name><![CDATA[docu-test-case.nl]]></domain:name> <domain:crDate><![CDATA[2016-09-07T11:10:45.000000+0000]]></domain:crDate> <domain:exDate><![CDATA[2017-09-07T00:00:00.000000+0000]]></domain:exDate> </domain:creData> </resData> <trID> <svTRID>MTR_a5959ce02fc1d1307b8de677b31c47188360ce17</svTRID> <clTRID>57cff5b3a60a7</clTRID> </trID> </response> </epp>

Response code 1001 received

Occasionally, when you create a domain name with additional data, or a registry that does not create the domain name immediately, you might get response code 1001 returned. <?xml version="1.0" encoding="UTF-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <command> <create> <domain:create> <domain:name>docu-dnssec-case2.nl</domain:name> <domain:ns> <domain:hostObj>ns1.metaregistrar.com</domain:hostObj> <domain:hostObj>ns2.metaregistrar.com</domain:hostObj> </domain:ns> <domain:registrant>RP012rfX8Wa3dE9u4Nu59g6J</domain:registrant> <domain:contact type="admin">RP012rfX8Wa3dE9u4Nu59g6J</domain:contact> <domain:contact type="tech">RP012rfX8Wa3dE9u4Nu59g6J</domain:contact> <domain:contact type="billing">RP012rfX8Wa3dE9u4Nu59g6J</domain:contact> <domain:authInfo> <domain:pw>abded</domain:pw> </domain:authInfo> </domain:create> </create> <extension> <secDNS:create xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1"> <secDNS:keyData> <secDNS:flags>257</secDNS:flags> <secDNS:protocol>3</secDNS:protocol> <secDNS:alg>13</secDNS:alg> <secDNS:pubKey>mdsswUyr3DPW132mOi8V9xESWE8jTo0dxCjjnopKl+GqJxpVXckHAeF+KkxLbxILfDLUT0rAK9iUzy1L53eKGQ==</secDNS:pubKey> </secDNS:keyData> </secDNS:create> </extension> <clTRID>57cffbb9f3dcc</clTRID> </command> </epp> The response code 1001 means: Request was processed succesfully, but not all associated actions were ready at the time of return. Your system will receive an epp:poll message after some time to indicate when the domain name is completely finished and ready to use. Please check out more here: poll messages <?xml version="1.0" encoding="UTF-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <response> <result code="1001"> <msg>Command completed successfully; action pending</msg> </result> <trID> <svTRID>MTR_ca1e570a3f708156e20c5a2259fd0255b475f33d</svTRID> <clTRID>57cffbb9f3dcc</clTRID> </trID> </response> </epp>