WebNIC RESTFUL v2
Domain APISSL APIDNS APIUtility Endpoints
Domain APISSL APIDNS APIUtility Endpoints
WebNIC OST @ Github
WebNIC Partner Portal
  1. Contact
  • 📝 Update History
  • IDN Language Code
  • Contact
    • Create Contact
      POST
    • Query Contact Info
      GET
    • Modify Contact
      POST
    • Delete Contact
      DELETE
    • Create Contact at Registry
      POST
    • Modify Contact at Local System only
      POST
    • Modify Contact at Registry
      POST
  • Registrant
    • Create Registrant Account
      POST
    • Get Registrant Account List
      GET
    • Send Login Info
      POST
    • Update Registrant User by Domain List
      PUT
    • Modify Registrant Account
      PUT
  • Domain Product
    • Get Extension Price
      POST
    • Get Extensions Promo Pricing
      POST
    • Smart Query by TLDs
      GET
    • Get Domain Extensions
      GET
    • Get Extensions Rule (RG)
      GET
    • Get Extensions Rule (TF)
      GET
    • Get Extensions Rule (GRACE)
      GET
    • Get Extensions Rule (DOC)
      GET
    • Suspend Domain
      POST
    • Get Domain Suspend Status
      GET
  • Domain
    • Check Domain Pattern
      GET
    • Query Domain
      GET
    • Count Total Domains
      GET
    • Get Domain Info
      GET
    • Get Universal WHOIS Information
      GET
    • Update Domain Status
      PUT
    • Get WebNIC Default Nameservers
      GET
    • Update Domain Nameserver
      PUT
    • Toggle Whois Privacy
      PUT
    • Toggle Proxy Subscription
      PUT
    • Register Domain
      POST
    • Renew Domain
      POST
    • Restore Domain
      POST
    • Delete Domain
      DELETE
    • Resend Domain Verification Email
      POST
    • Download Certificate
      GET
    • Reset Authorization Information
      POST
    • Send Authorization Information
      POST
    • Upload Verification Document
      POST
    • Get Domain Statistics
      GET
    • Get Top Domain Available List
      GET
  • Domain Host
    • Check Host
    • Get Host Info
    • Modify Host
    • Get Host List (Pagination)
    • Create Host By Extension
    • Delete Host By Extension
    • Get Host Registered Registries
    • Get Host linked Domain List
  • Domain DNSSEC
    • Check DNSSEC Supported
    • Get DNSSEC Info
    • Update DNSSEC
    • Delete DNSSEC
  • Domain Transfer
    • Query Transfer Type
    • Submit Reseller Transfer
    • Submit Registrar Transfer In
    • Get Registrar Transfer In Status by Domain Name
    • Get Registrar Transfer In Status by Id
    • Get Registrar Transfer Away Status by Domain Name
    • Get Registrar Transfer Away Status by Id
    • Update Registrar Transfer Away Status
    • Get Reseller Transfer Status by Domain Name
    • Get Reseller Transfer Status by Id
    • Update Reseller Transfer Away Status
  • Pending Order
    • Get Pending Order Info
  • Domain Action Log
    • Get Domain Action Log Info
  • Registry Program
    • Bundle HK Domain
    • Check Free TW Domain Eligibility
  • Domain Broker
    • Initiate Domain Broker
  • Secondhand Domain
    • Insert Secondhand Domain
  • Bulk Request
    • Bulk Domain Registration
    • Bulk Domain Renewal
    • Bulk Replace Contact
    • Get Bulk Report Overview
    • Get Bulk Report Details
Domain APISSL APIDNS APIUtility Endpoints
Domain APISSL APIDNS APIUtility Endpoints
WebNIC OST @ Github
WebNIC Partner Portal
  1. Contact

Create Contact

OTE Environment
https://oteapi.webnic.cc
OTE Environment
https://oteapi.webnic.cc
POST
/domain/v2/contact/create
Last modified:2025-07-01 03:54:15
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 NameTypeDescription
organizationTypeStringOrganization type
Allowed values: OTA000005, OTA000003, OTA000025, OTA000006, OTA000012, OTA000032
organizationRegistrationNumberStringOrganization 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 CodeExplanation
OTA000005Business
OTA000003Company
OTA000025Non Profit Organization
OTA000006Education
OTA000012Legal Professional
OTA000032Others
ORGOrganization Code Certificate
YYZZChina Business License
TYDMCertificate for Uniform Social Credit Code
BDDMMilitary Code Designation
JDDWFWMilitary Paid External Service License
SYDWFRPublic Institution Legal Person Certificate
SHTTFRSocial Organization Legal Person Registration Certificate
ZJCSReligion Activity Site Registration Certificate
MBFQYPrivate Non-Enterprise Entity Registration Certificate
JJHFRFund Legal Person Registration Certificate
LSZYPracticing License of Law Firm
WGZHWHRegistration Certificate of Foreign Cultural Center in China
WLCZJGResident Representative Office of Tourism Departments of Foreign Government Approval Registration Certificate
SFJDJudicial Expertise License
JWJGOverseas Organization Certificate
SHFWJGSocial Service Agency Registration Certificate
MBXXBXPrivate School Permit
YLJGZYMedical Institution Practicing License
GZJGZYNotary Organization Practicing License
BJWSXXBeijing School for Children of Foreign Embassy Staff in China Permit

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Examples

Responses

🟢200OK (Create All 4 sets Contact)
application/json
Body

🟢200OK (Create Specific Contact)
🟢200Create Contact - webnic OTE
Request Request Example
Shell
JavaScript
Java
Swift
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"
        }
    }
}'
Response Response Example
200 - OK (Create All 4 sets Contact) - OK (Create All 4 sets Contact)
{
    "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
        }
    ]
}
Modified at 2025-07-01 03:54:15
Previous
Contact
Next
Query Contact Info
Built with