Loading...

Knowledge Base
Home 
 
/
 Set Default Contacts for a Customer Using the API
Categories: Customer Account Management API

Set Default Contacts for a Customer Using the API

When you want to set default contacts for a customer using the API. This article explains supported contact types, required contact IDs, TLD-specific restrictions, and response details for updating default domain contacts.

Setting a Default Contact

 

Description

Sets a default contact for the Customer.

Parameters

NameData TypeRequired / OptionalDescription
auth-useridIntegerRequiredAuthentication Parameter
api-keyStringRequiredAuthentication Parameter
customer-idIntegerRequiredThe Customer for whom you want to set the Default Contacts
typeArray of StringsRequiredType of default contact to be returned. It can be one or more of following contacts types : Contact, CoopContact, UkContact, EuContact, CnContact, CoContact, CaContact, DeContact, EsContact.
reg-contact-idIntegerRequiredThe Registrant Contact of the domain name.
admin-contact-idIntegerRequired

The Administrative Contact of the domain name.

Note

Pass -1 for the following TLDs:

  • .EU

  • .NZ

  • .RU

  • .UK

tech-contact-idIntegerRequired

The Technical Contact of the domain name.

Note

Pass -1 for the following TLDs:

  • .EU

  • .NZ

  • .RU

  • .UK

billing-contact-idIntegerRequired

The Billing Contact of the domain name.

Note

Pass -1 for the following TLDs:

  • .BERLIN

  • .CA

  • .EU

  • .NL

  • .NZ

  • .RU

  • .UK

  • .LONDON

HTTP Method

POST

Example Test URL

https://httpapi.com/api/contacts/modDefault.json?auth-userid=0&api-key=key&customer-id=0&type=Contact&reg-contact-id=0&admin-contact-id=0&tech-contact-id=0&billing-contact-id=0

Response

Returns a hash map containing the below details of the Default Contacts for each Contact Type requested:

  • registrantContactDetails / adminContactDetails / techContactDetails / billingContactDetails:

    • Contact ID (entity.entityid)

    • Name (contact.name)

    • Company (contact.company)

    • Contact Type (contact.type)

    • Email Address (contact.emailaddr)

    • Telephone Number Country Code (contact.telnocc)

    • Telephone Number (contact.telno)

    • First line of address of the Contact (contact.address1)

    • Second line of address of the Contact (contact.address2)

    • Third line of address of the Contact (contact.address3)

    • City (contact.city)

    • State (contact.state)

    • Country Code (contact.country)

    • ZIP Code (contact.zip)

    • Current Status in the System (entity.currentstatus)

    • Creation Date in the System (contact.creationdt)

    • Creation Date at the Registry (contact.timestamp)

    • Customer ID associated with the Contact (entity.customerid)

  • Registrant Contact ID (registrant)

  • Admin Contact ID (admin)

  • Tech Contact ID (tech)

  • Billing Contact ID (billing)

  • Contact Type (type)

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