Create Contact

Domain contact creation.

💡

You can create all 4 sets contacts at the same time, or specific contact type one at a time.

Please refer appendix section for further description of respective custom field values.

Required Custom Fields for common TLDs

Organization

Individual

Field Name	Type	Description
organizationType	String	Organization type Allowed values: `OTA000005`, `OTA000003`, `OTA000025`, `OTA000006`, `OTA000012`, `OTA000032`
organizationRegistrationNumber	String	Organization registration number

Required Custom Fields for specific TLDs

for .com.cn, .gov.cn, .net.cn, .org.cn, .cn, .中国, .公司, .网络

for .us

for .vn

for .hk, .com.hk, .my

Appendix: Unique Code Explanation

Organization

Individual

Nexus

Unique Code	Explanation
OTA000005	Business
OTA000003	Company
OTA000025	Non Profit Organization
OTA000006	Education
OTA000012	Legal Professional
OTA000032	Others
ORG	Organization Code Certificate
YYZZ	China Business License
TYDM	Certificate for Uniform Social Credit Code
BDDM	Military Code Designation
JDDWFW	Military Paid External Service License
SYDWFR	Public Institution Legal Person Certificate
SHTTFR	Social Organization Legal Person Registration Certificate
ZJCS	Religion Activity Site Registration Certificate
MBFQY	Private Non-Enterprise Entity Registration Certificate
JJHFR	Fund Legal Person Registration Certificate
LSZY	Practicing License of Law Firm
WGZHWH	Registration Certificate of Foreign Cultural Center in China
WLCZJG	Resident Representative Office of Tourism Departments of Foreign Government Approval Registration Certificate
SFJD	Judicial Expertise License
JWJG	Overseas Organization Certificate
SHFWJG	Social Service Agency Registration Certificate
MBXXBX	Private School Permit
YLJGZY	Medical Institution Practicing License
GZJGZY	Notary Organization Practicing License
BJWSXX	Beijing School for Children of Foreign Embassy Staff in China Permit

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://oteapi.webnic.cc/domain/v2/contact/create' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "registrant": { "category": "individual", "company": "", "firstName": "John", "lastName": "Smith", "address1": "Technology Park Malaysia", "city": "Kuala Lumpur", "state": "Kuala Lumpur", "countryCode": "MY", "zip": "98000", "phoneNumber": "+60.123456789", "email": "john.smith@gmail.com", "customFields": { "dateOfBirth": "1999-12-31", "gender": "male", "identificationNumber": "C000101081122", "individualType": "TWJMTX", "nexus": "C12" } } }'

{ "code": "1000", "message": "Command completed successfully.", "data": [ { "contactId": "WNC970363T", "resid": 2740, "details": { "category": "organization", "company": "Web NIC INC.", "firstName": "John", "lastName": "Smith", "address1": "Technology Park Malaysia", "address2": null, "city": "Kuala Lumpur", "state": "Kuala Lumpur", "countryCode": "MY", "zip": "98000", "phoneNumber": "+60.123456789", "email": "john.smith@gmail.com", "customFields": { "organizationType": "ORG", "organizationRegistrationNumber": "1111111", "identificationNumber": "000101081122" }, "authInfo": null }, "contactType": "registrant", "dtcreate": null }, { "contactId": "WNC970364T", "resid": 2740, "details": { "category": "individual", "company": "qinetics.net", "firstName": "John", "lastName": "Smith", "address1": "Technology Park Malaysia", "address2": null, "city": "Kuala Lumpur", "state": "Kuala Lumpur", "countryCode": "MY", "zip": "98000", "phoneNumber": "+60.123456789", "faxNumber": null, "email": "john.smith@gmail.com", "customFields": { "organizationType": "ORG", "organizationRegistrationNumber": "1111111", "identificationNumber": "000101081122" }, "authInfo": null }, "contactType": "administrator", "dtcreate": null }, { "contactId": "WNC970365T", "resid": 2740, "details": { "category": "individual", "company": "qinetics.net", "firstName": "John", "lastName": "Smith", "address1": "Technology Park Malaysia", "address2": null, "city": "Kuala Lumpur", "state": "Kuala Lumpur", "countryCode": "MY", "zip": "98000", "phoneNumber": "+60.123456789", "faxNumber": null, "email": "john.smith@gmail.com", "customFields": { "organizationType": "ORG", "organizationRegistrationNumber": "1111111", "identificationNumber": "000101081122" }, "authInfo": null }, "contactType": "technical", "dtcreate": null }, { "contactId": "WNC970366T", "resid": 2740, "details": { "category": "individual", "company": "qinetics.net", "firstName": "John", "lastName": "Smith", "address1": "Technology Park Malaysia", "address2": null, "city": "Kuala Lumpur", "state": "Kuala Lumpur", "countryCode": "MY", "zip": "98000", "phoneNumber": "+60.123456789", "faxNumber": null, "email": "john.smith@gmail.com", "customFields": { "organizationType": "ORG", "organizationRegistrationNumber": "1111111", "identificationNumber": "000101081122" }, "authInfo": null }, "contactType": "billing", "dtcreate": null } ] }

Required Custom Fields for common TLDs

Required Custom Fields for specific TLDs

Appendix: Unique Code Explanation

Request

Responses

Create Contact

Required Custom Fields for common TLDs#

Required Custom Fields for specific TLDs#

Appendix: Unique Code Explanation#

Request

Responses

Required Custom Fields for common TLDs

Required Custom Fields for specific TLDs

Appendix: Unique Code Explanation