Create a DNS Record

Similar to creating a DNS zone, you need to provide the UUID of the DNS zone to host the new record.

To create a DNS zone of Type A, follow this step:

• Perform a POST request with these details:

  • corresponding UUID of the DNS zone,

  • name of the subdomain; example: www

  • record type; in this case: A,

  • content or destination of the A record in the form of an IPv4 address; example: 1.1.1.1

  • TTL you need (minimum 60 seconds and maximum 86.400 seconds), and

  • status of the DNS record (enable), true or false.

Request

curl --location \  
--request POST 'https://dns.de-fra.ionos.com/zones/2a4428b3-dbe0-4357-9c02-609025b3a40f/records' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiO' \
--header 'Content-Type: application/json' \
--data '{
   "properties": {
    "name": "*",
    "type": "A",
    "content": "1.2.3.4",
    "ttl": 3600,
    "enabled": true
  }

}'

Response

202 Successful operation

{
  "id": "90d81ac0-3a30-44d4-95a5-12959effa6ee",
  "metadata": {
    "lastModifiedDate": "2022-08-21T15:52:53Z",
    "createdDate": "2022-08-21T15:52:53Z",
    "state": "CREATED",
    "fqdn": "*.example.com",
    "zoneId": "2a4428b3-dbe0-4357-9c02-609025b3a40f"
  },
  "properties": {
    "name": "*",
    "type": "A",
    "content": "1.2.3.4",
    "ttl": 3600,
    "enabled": true
  }
}

Response Fields

Create records of other types

Create records of other types Cloud DNS supports the following record types: A, AAAA , CNAME, ALIAS, MX, NS, SOA, SRV, TXT, CAA, SSHFP, TLSA, SMIMEA, DS, HTTPS, SVCB, OPENPGPKEY, CERT, URI, RP and LOC.

Here is a brief explanation of the most common record types:

• A: Specifies the IPv4 address associated with a zone name.

• AAAA: Specifies the IPv6 address associated with a zone name.

• MX: Specifies the mail exchange servers for a zone name.

• CNAME: Specifies an alias for a zone name, allowing multiple names to resolve to the same IP address.

• TXT: Allows arbitrary text to be associated with a zone name that is commonly used for SPF records and other types of verification.

• NS: Specifies the name servers for a zone name.

• SRV: Specifies the location of services for a zone name that is commonly used for Session Initiation Protocol (SIP) and other protocols.

Here you can see examples of records with different record types:

Quota

To retrieve the quota of DNS records, perform a GET request to the /quota endpoint.

Request

curl --location 'https://dns.de-fra.ionos.com/quota' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiO' \
--header 'Content-Type: application/json'

Response

200 OK

{
  "quotaLimits": {
    "records": 100000,
    "reverseRecords": 5000,
    "secondaryZones": 100000,
    "zones": 50000
  },
  "quotaUsage": {
    "records": 9,
    "reverseRecords": 1,
    "secondaryZones": 6,
    "zones": 5
  }
}

Response Fields