# Create Vanity Nameserver

Register a new vanity nameserver for the specified domain.

Endpoint: POST /core/v1/domains/{domainName}/vanity_nameservers
Version: 1.3.1
Security: BasicAuth

## Path parameters:

  - `domainName` (string, required)
    The domain name to create a vanity nameserver for.
    Example: "example.com"

## Request fields (application/json):

  - `hostname` (string, required)
    The subdomain portion of the nameserver hostname. The domain portion will be  taken from the URL path. For example, to create 'ns1.example.com', specify 'ns1'  when calling the endpoint for the domain 'example.com'.
    Example: "ns1"

  - `ips` (array, required)
    IPs is a list of IP addresses that are used for glue records for this nameserver. These should be valid IPv4 or IPv6 addresses.
    Example: ["192.168.1.10","2001:0db8:85a3:0000:0000:8a2e:0370:7334"]

## Response 200 fields (application/json):

  - `domainName` (string, required)
    DomainName is the root domain for which this vanity nameserver is created. For example, if the hostname is 'ns1.example.com', the domainName would be 'example.com'.
    Example: "example.com"

  - `hostname` (string, required)
    Hostname is the fully qualified domain name (FQDN) of the vanity nameserver. It must be a subdomain of the domain specified in 'domainName'.
    Example: "ns1.example.com"

  - `ips` (array, required)
    IPs is a list of IP addresses that are used for glue records for this vanity nameserver. These should be valid IPv4 or IPv6 addresses.
    Example: ["192.168.1.1","2001:0db8:85a3:0000:0000:8a2e:0370:7334"]

## Response 400 fields (application/json):

  - `message` (string)
    A human-readable message providing more details about the error
    Example: "Bad Request"

  - `details` (string,null)
    Additional context or information about the error
    Example: "'domainName' cannot be null"

## Response 403 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "Permission denied"

  - `details` (string,null)
    Additional context or information about the error
    Example: "Failed authentication"

## Response 404 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "Not Found"

  - `details` (string,null)
    Additional context or information about the error
    Example: "The requested domain does not exist."

## Response 415 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "The 'Content-Type' header must be 'application/json' for this request."

## Response 429 fields (application/json):

  - `message` (string)
    A human-readable message providing more details about the error
    Example: "Rate Limit Exceeded"

## Response 500 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error.
    Example: "Internal Server Error"

  - `details` (string,null)
    Additional context or information about the error.
    Example: "Something went wrong."