Add Contact


Adds a Contact to the domain using the details provided.


Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
name String Required

Name of the Contact

  • Max length 255 characters

company String Required

Name of the Company

  • Max length 255 characters

email String Required Email address of the Contact
address-line-1 String Required First line of address of the Contact
  • Max length 64 characters

  • For NycContact Contact type, a physical street address in the New York City must be provided.

city String Required Name of the City

Max length 64 characters

country String Required

Country code as per ISO 3166-1 alpha-2


For UkServiceContact Contact type, the country code can only be GB (United Kingdom), IM (Isle of Man), JE (Jersey) or GG (Guernsey).

zipcode String Required ZIP code

Max length 10 characters


ZIP Code will be validated against the Country selected during the contact create process. An invalid zipcode will return an error message.

phone-cc String Required Telephone number country code

Between 1-3 digits


Only valid telephone number country code will be accepted.

phone String Required Telephone number

Between 4-12 digits

customer-id Integer Required The Customer under whom you want to create the Contact
type String Required

The Contact Type. This can take following values:

  • Contact

  • BrContact or BrOrgContact

  • MxContact

address-line-2 String Optional Second line of address of the Contact
address-line-3 String Optional Third line of address of the Contact
state String Optional

Name of the State

  • Max length 64 characters

fax-cc String Optional Fax number country code

Between 1-3 digits

fax String Optional Fax number

Between 4-12 digits

attr-name Map[name] Optional Mapping key of any extra information to be associated for the contact that is being added. Refer the description of attr-value.
attr-value Map[value] Required

Mapping value of the extra details required to be associated with a particular Contact before registering a domain name. This together with attr-name shall contain the extra details.

  • To associate the Contact with a .BR domain name, the input can be:

    attr-name1=organisationId&attr-value1={Organisation ID}
    • Organisation ID: Only Brazilian nationals or organizations can register .BR domains. Hence, a tax ID (CPF in case of an individual contact) or an organisation ID (CNPJ in case of a company contact) of the person/organisation needs to be supplied for the Registrant contact (BrOrgContact). The tax/organization ID must either not be currently registered in our database or it should be a transferred authority to the registrar through the .BR registry web interface.

    • In addition, depending on the contact, you will need to specify the “type” as BrOrgContact (for the Registrant contact) or BrContact (for the Admin/technical/Billing contact). The Admin, technical and Billing contact should not be associated with the organization ID mentioned above. This is only needed for the Registrant contact.

  • To associate the Contact with a .JOBS domain name, the input can be:

    attr-name1=title&attr-value1={Title of the Contact in the Company} attr-name2=website&attr-value2={Company Website} attr-name3=industry_type&attr-value3={Type / Classification of the industry in which the company conducts its business} attr-name4=is_admin_contact&attr-value4={true | false} attr-name5=is_association_member&attr-value5={true | false}

    This information has to be associated with all Contacts of the .JOBS domain name.

  • To associate the Contact with a .PRO domain name, input should have professional information to be associated with the Contact ID as follows:

    attr-name1=profession&attr-value1={Any of the values mentioned below}
    • Acupuncturists

    • Allied Health Professionals

    • Ambulance Services

    • Architects

    • Asbestos Removal Professionals

    • Barbers and Barber Shops

    • Certified Financial Analysts

    • Certified Financial Planners

    • Certified Public Accountants

    • Check Cashers

    • Chiropractors

    • Contractors, Home Improvement

    • Cosmetologists and Aestheticians

    • Debt Collectors

    • Dentists and Dental Hygienists

    • Dieticians and Nutritionists

    • Doctors

    • Educators

    • Electricians

    • Electrologists

    • Emergency Medical Technician

    • Engineers and Land Surveyors

    • Finance Companies

    • Financial Professional

    • Funeral Services

    • Health Care

    • Hearing Instrument Specialists

    • Home Inspectors

    • HVAC Technicians

    • Insurance

    • Investment Advisors

    • Landscape Architects

    • Lawyers

    • Lead Paint Inspectors

    • Manufactured Building Producers

    • Massage Therapy

    • Money Transmitters

    • Mortgage Lenders and Brokers

    • Municipal Building Inspectors

    • Nurses and Nurse Aides

    • Nursing Home Administrators

    • Nutritionists

    • Opticians

    • Optometrists

    • Perfusionist

    • Pharmacists

    • Physical Therapists

    • Physician Assistants

    • Physicians

    • Plumbers and Gas Fitters

    • Podiatrists

    • Psychologists

    • Public Relations

    • Radio and TV Technicians

    • Real Estate

    • Real Estate Appraisers

    • Respiratory Therapists

    • Sanitarians

    • Social Workers

    • Speech Pathologists and Audiologists

    • Veterinarians

    • Water Plant Operator

    • X-Ray Technicians

    • Internet Professional

    • Medical Professional

    • Legal Professional

    • Other (If your profession does not match any of the above mentioned values, you may provide your own value and it will be included under Other in our system.)


    This information has to be associated with Registrant Contact of the domain name.

HTTP Method


Example Test URL Request


Returns the Contact Id (Integer) of newly added Contact. Multiple Contacts can be added for the same Name and Company Name behavior.

In case of any errors, a status key with value as ERROR alongwith an error message will be returned.

Sample error message when Single Field is invalid {"status":"ERROR","message":"{telnocc=TelephoneNo Country Code is invalid}"}

Sample error message when Multiple Fields are invalid {"status":"ERROR","message":"{telnocc=TelephoneNo Country Code is invalid, zip=Postal Code is invalid}"}