# 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.

Endpoint: POST /contacts
Version: 1.0.0
Security: bearer

## Query parameters:

  - `$preview` (boolean, required)

## Request fields (application/json):

  - `firstName` (string, required)

  - `lastName` (string, required)

  - `organization` (string)

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

  - `street` (string, required)

  - `city` (string, required)

  - `postalCode` (string, required)
    Postal/ZIP code. Validated against the provided countryCode.

  - `stateProvince` (string, required)
    State or province. Validated against the provided countryCode.

  - `phone` (object, required)
    Phone number with international dialing prefix.

  - `phone.number` (string, required)
    Phone number digits (numeric string, 6-14 characters).

  - `phone.dialingPrefix` (string, required)
    International dialing prefix (e.g., "+1" for US/CA, "+44" for UK).
    Example: "+1"

  - `email` (string, required)

## Response 201 fields (application/json):

  - `@type` (string, required)
    Enum: "unstoppabledomains.com/partner.v3.ContactOperationResult"

  - `operation` (object, required)

  - `operation.id` (string, required)
    Operation ID
    Example: "op-a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `operation.status` (string, required)
    Enum: "PREVIEW", "QUEUED", "PROCESSING", "FAILED", "COMPLETED", "CANCELLED", "AWAITING_UPDATES"

  - `operation.type` (string, required)
    Enum: "ADMIN_GENERIC", "DOMAIN_ADMIN_UPDATE", "DOMAIN_RENEW", "ACCOUNT_UPDATE", "DOMAIN_DNS_RECORD_CREATE", "DOMAIN_DNS_RECORD_UPDATE", "DOMAIN_DNS_RECORD_DELETE", "DOMAIN_DNS_RECORD_BATCH", "DOMAIN_DNS_SECURITY_ENABLE", "DOMAIN_DNS_SECURITY_DELETE", "DOMAIN_DNS_NAME_SERVER_UPDATE", "DOMAIN_HOSTING_UPDATE", "DOMAIN_HOSTING_DISABLE", "DOMAIN_TRANSFER_OUT", "DOMAIN_TRANSFER_OUT_TOGGLE", "DOMAIN_FLAGS_UPDATE", "DOMAIN_CONTACTS_UPDATE", "CONTACT_CREATE", "DOMAIN_SUGGESTION_CREATE", "DOMAIN_SUGGESTION_REFRESH"

  - `operation.domain` (string)

  - `operation.createdAtTimestamp` (number, required)

  - `operation.lastUpdatedTimestamp` (number, required)

  - `operation.validUntilTimestamp` (number)

  - `operation.dependencies` (array, required)
    List of platform operation dependencies that make up this operation