contacts

Create a contact

Create a new contact for use in domain registration and management. A verification email will be sent to the contact's email address. Use $preview=true to validate without creating the contact.

post/contacts

Query parameters

$previewboolean required

Request body

firstNamestring required

lastNamestring required

organizationstring

countryCodestring required

ISO 3166-1 alpha-2 country code (e.g., "US", "CA", "GB")

streetstring required

citystring required

postalCodestring required

Postal/ZIP code. Validated against the provided countryCode.

stateProvincestring required

State or province. Validated against the provided countryCode.

emailstring email required

Example request

{
  "phone": {
    "dialingPrefix": "+1"
  }
}

Response

Contact creation operation

@type'unstoppabledomains.com/partner.v3.ContactOperationResult' required

Example response

{
  "operation": {
    "id": "op-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "dependencies": [
      {
        "id": "plop_abc12345-1234-1234-1234-abc123456789",
        "parameters": {
          "owner": {
            "id": "con_abc12345-1234-1234-1234-abc123456789"
          },
          "contacts": {
            "admin": {
              "id": "con_abc12345-1234-1234-1234-abc123456789"
            },
            "billing": {
              "id": "con_abc12345-1234-1234-1234-abc123456789"
            },
            "tech": {
              "id": "con_abc12345-1234-1234-1234-abc123456789"
            }
          },
          "period": 1
        }
      }
    ]
  }
}

Changes

Changed in 3 of the 26 revisions of this API.146

Feb 27, 202664f751be432d15See the full diff
- ●
  added the new DOMAIN_ADMIN_DNS_ZONE_MIGRATE enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 20, 20261e6c3ab94bc01See the full diff
- ●
  removed the request property
  request-property-removed
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 20, 2026acf7620da368121See the full diff
- ▲
  added to the // response property oneOf list for the response status
  response-property-one-of-added
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  added the new DOMAIN_DNS_NAME_SERVER_UPDATE enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added DOMAIN_SET_NAMESERVERS DOMAIN_DNS_SECURITY_SET_DNSSEC DOMAIN_DNS_SECURITY_DELETE_DNSSEC DOMAIN_DNS_SECURITY_UPDATE_ZONE discriminator mapping keys to the // response property for the response status
  response-property-discriminator-mapping-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history