Skip to main content

Record configuration and management

Updated

Summary

A feature that enables users to configure, manage, and retrieve the DNS record types of both primary and secondary domains.

Description

DigiCert®​​ DNS provides a centralized interface for managing DNS records, configuring different record types, and customizing primary and secondary domains to ensure accurate and efficient resolution. Centralized management enhances DNS accuracy, reduces administrative overhead, and improves domain performance.

Related Functions

  • Primary domain record management: This function provides complete control over DNS records for primary domains.
  • Secondary domain record management: This function enables DNS record management for secondary domains, supporting redundancy and failover.
  • Record retrieval: This function allows users to retrieve every DNS record within their system.
  • A record management: This function enables users to configure A records to map domain names to IPv4 addresses.
  • AAAA record management: This function supports the management of AAAA records to associate domain names with IPv6 addresses.
  • CAA record management: This function allows users to define CAA records to control which CAs can issue SSL/TLS certificates.
  • CNAME record management: This function facilitates the management of CNAME records for aliasing domain names to another canonical name.
  • MX record management: This function enables users to configure MX records to direct email traffic to the correct mail servers.
  • NS record management: This function provides control over NS records to define authoritative nameservers for a domain.
  • PTR record management: This function supports the management of PTR records for reverse DNS lookups, mapping IP addresses to domain names.
  • SOA record configuration: This function allows users to define SOA records for domain zone control and authority settings.
  • SRV record management: This function allows users to configure SRV records to define service locations for specific protocols.
  • TXT record management: This function enables the addition and management of TXT records for domain verification and security purposes.

Primary domain record management

Notice

In DigiCert®​​ DNS, managed domains (as seen in the UI) are referred to as primary domains in the documentation. Both terms refer to the same concept.

Overview

This guide provides detailed instructions for primary domain record management, covering a series of targeted actions, including:

Benefits

Primary domain record management enables efficient updates across all records linked to the primary domain. With DigiCert®​​ DNS, changes propagate automatically, reducing manual effort and improving consistency. This centralized approach enhances resolution times, scalability, and policy enforcement, simplifying DNS maintenance while minimizing errors and ensuring smooth, reliable operations.

Procedures

Clear multiple records from a specific primary domain

Notice

This procedure clears two records (arecord and aaaarecord) from a specific primary domain (domain1) created in an earlier procedure.

To test this function, call this API endpoint: POST /domains/primary/{domainId}/records/bulk/delete

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.

  3. Select the MANAGED DNS tab.

    The table displays all the primary domains associated with the account.

  4. Select the name of the primary domain (for example, domain1) whose records you want to clear - see Path 2 for quick filtering.
  5. In the RECORDS tab, select the checkboxes of the records you want to clear (for example, arecord and aaaarecord).
  6. Go to Actions > Delete Records.

  7. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful clearance of the records.

Delete the records of a specific primary domain

Notice

This procedure deletes all records from a specific primary domain (domain1) created in an earlier procedure.

To test this function, call this API endpoint: DELETE /domains/primary/{domainId}/records

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.

  3. Select the MANAGED DNS tab.

    The table displays all the primary domains associated with the account.

  4. Select the name of the primary domain (for example, domain1) whose records you want to delete - see Path 2 for quick filtering.
  5. In the RECORDS tab, select the Record Type checkbox.
  6. Go to Actions > Delete Records.

  7. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the records.

List the records of a specific primary domain

Notice

This procedure displays the records of a specific primary domain (domain1). The primary domain was previously created here.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.

  3. Select the MANAGED DNS tab.

    The table displays all the primary domains associated with the account.

  4. Select the name of the primary domain (for example, domain1) whose records you want to view - see Path 2 for quick filtering.

  5. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.

Secondary domain record management

Overview

This guide provides detailed instructions for secondary domain record management, focusing on a single targeted action: listing the records of a specific secondary domain.

Benefits

Secondary domain record management enhances DNS performance and redundancy by distributing query traffic across multiple servers. Using DigiCert®​​ DNS, users achieve faster failover, reduced load on primary servers, and improved infrastructure resilience. Centralized management minimizes manual updates, safeguards records from errors or malicious changes, and ensures continuous protection and uptime.

Procedure

List the records of a specific secondary domain

Notice

This procedure displays the records of a specific secondary domain (domain1). The secondary domain was previously created here.

To test this function, call this API endpoint: GET /domains/secondary/{domainId}/records

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.

  3. Select the SECONDARY DNS tab.

    The table displays all the secondary domains associated with the account.

  4. Select the name of the secondary domain (for example, domain1) whose records you want to view - see Path 2 for quick filtering.

  5. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.

Record retrieval

Overview

This guide provides detailed instructions for listing all available DNS record types.

Benefits

Instant record retrieval in DigiCert®​​ DNS provides complete visibility into all DNS configurations, enabling faster troubleshooting, precise audits, and proactive issue resolution. Teams can quickly identify inconsistencies or unauthorized changes, streamlining operations and strengthening domain security.

Procedure

List all available record types

Notice

The current version of DigiCert®​​ DNS does not include a dedicated front-end tab for viewing all available record types. To access this information, use the following endpoint:

GET /recordtypes

For help configuring your testing environment, refer to the API guide.

A record management

Notice

In DigiCert®​​ DNS, managed domains (as seen in the UI) are referred to as primary domains in the documentation. Both terms refer to the same concept.

Overview

This guide provides detailed instructions for A record management, covering a series of targeted actions, including:

Benefits

Effective A record management ensures fast domain resolution, optimized website performance, and simplified troubleshooting. With DigiCert®​​ DNS, users gain precise control over domain mapping, improved redundancy, and better resource allocation. Centralized management strengthens failover mechanisms, enhances security, and provides scalable network control for greater reliability and uptime.

Procedures

Create an A record

Notice

This procedure creates an A record (arecord) for the primary domain domain1, pointing to two IP addresses (1.1.1.1 and 2.2.2.2). The primary domain was previously created here.

To test this function, call this API endpoint: POST /domains/primary/{domainId}/records/A

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. Select the RECORDS tab.
  5. Select the Add Record button.
  6. In the Add Record dialog:
    1. Select A from the Record Type drop-down list.
    2. Enter a name in the Name field (for example, arecord).
    3. Set the TTL value, or keep the default of 600.
    4. Ensure the Standard checkbox (under Select Record Mode) is selected.

    5. In the IP field, enter one or more valid IP addresses (for example, 1.1.1.1 and 2.2.2.2).

      Do not disable the Enabled toggle next to each IP address.

    6. (Optional) Select Save and Add Another to add more records.

    7. Select Save and Close to finish.

      A message appears confirming the successful creation of the record.

Delete a specific A record

Notice

This procedure deletes a specific A record (arecord) from the primary domain domain1. The primary domain and A record were created in earlier procedures. You can follow either Path 1 or Path 2 to complete the deletion.

To test this function, call this API endpoint: DELETE /domains/primary/{domainId}/records/A/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. In the RECORDS tab, locate the record you want to delete (for example, arecord).
  5. From the overflow menu (three vertical dots) at the end of the record's row, select Delete.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. In the RECORDS tab, select the checkbox of the record you want to delete.

    Tip

    You can select multiple checkboxes to delete several records at once.

  5. Go to Actions > Delete Records.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

List the A records of a specific primary domain

Notice

This procedure displays the A records of a specific primary domain (domain1). The primary domain was previously created here. You can follow either Path 1 or Path 2 to complete the retrieval.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/A

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table:
    1. Under Column, select Record Type.
    2. Under Operator, select contains.
    3. Under Value, enter A.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Toggle Group Records to group records by type.
  6. Select the A record drop-down list.

Return the details of a specific A record

Notice

This procedure displays the details of a specific A record (arecord) created in an earlier procedure. Follow Path 1 if there are only a few results to review. Follow Path 2 if you prefer to filter results quickly.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/A/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the record (for example, arecord) whose details you want to view.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table to locate the specific record quickly.

    Tip

    In this example, the name of the record is known, so the following filter was applied:

    1. Under Column, select Name.
    2. Under Operator, select contains.

    3. Under Value, enter the record's name (arecord).

      If no results appear, double-check the Filters selections and input values.

  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.

Update a specific A record

Notice

This procedure updates a specific A record (arecord) created in an earlier procedure.

To test this function, call this API endpoint: PUT /domains/primary/{domainId}/records/A/{recordId}

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the specific record - see Path 2 for quick filtering.

  6. Select the name of the record (for example, arecord) whose details you want to update.

    Alternatively, select the overflow menu (three vertical dots) at the end of the record's row, and select Edit.

  7. In the Edit Record dialog:
    1. Edit the record's details as required.

    2. Select Save to finish.

      A message appears confirming the successful update of the record.

AAAA record management

Notice

In DigiCert®​​ DNS, managed domains (as seen in the UI) are referred to as primary domains in the documentation. Both terms refer to the same concept.

Overview

This guide provides detailed instructions for AAAA record management, covering a series of targeted actions, including:

Benefits

AAAA record management is crucial for optimizing DNS performance and supporting scalable, future-ready networks. Using DigiCert®​​ DNS, users can reduce network congestion, lower latency by avoiding IPv4-to-IPv6 translation, and provide seamless connectivity for modern devices. Centralized management improves security, ensures IPv6 compatibility, and enhances global reachability, resulting in faster, more reliable connections and streamlined end-to-end network configurations.

Procedures

Create a AAAA record

Notice

This procedure creates a AAAA record (aaaarecord) for the primary domain domain1. The primary domain was previously created here.

To test this function, call this API endpoint: POST /domains/primary/{domainId}/records/AAAA

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. Select the RECORDS tab.
  5. Select the Add Record button.
  6. In the Add Record dialog:
    1. Select AAAA from the Record Type drop-down list.
    2. Enter a name in the Name field (for example, aaaarecord).
    3. Set the TTL value, or keep the default of 600.

    4. Enter a valid IPv6 address in the IPv6 field.

      To add more entries, select Add Another IP.

    5. (Optional) Select Save and Add Another to add more records.

    6. Select Save and Close to finish.

      A message appears confirming the successful creation of the record.

Delete a specific AAAA record

Notice

This procedure deletes a specific AAAA record (aaaarecord) from the primary domain domain1. The primary domain and AAAA record were created in earlier procedures. You can follow either Path 1 or Path 2 to complete the deletion.

To test this function, call this API endpoint: DELETE /domains/primary/{domainId}/records/AAAA/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. In the RECORDS tab, locate the record you want to delete (for example, aaaarecord).
  5. From the overflow menu (three vertical dots) at the end of the record's row, select Delete.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. In the RECORDS tab, select the checkbox of the record you want to delete.

    Tip

    You can select multiple checkboxes to delete several records at once.

  5. Go to Actions > Delete Records.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

List the AAAA records of a specific primary domain

Notice

This procedure displays the AAAA records of a specific primary domain (domain1). The primary domain was previously created here. You can follow either Path 1 or Path 2 to complete the retrieval.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/AAAA

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table:
    1. Under Column, select Record Type.
    2. Under Operator, select contains.
    3. Under Value, enter AAAA.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Toggle Group Records to group records by type.
  6. Select the AAAA record drop-down list.

Return the details of a specific AAAA record

Notice

This procedure displays the details of a specific AAAA record (aaaarecord) created in an earlier procedure. Follow Path 1 if there are only a few results to review. Follow Path 2 if you prefer to filter results quickly.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/AAAA/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the record (for example, aaaarecord) whose details you want to view.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table to locate the specific record quickly.

    Tip

    In this example, the name of the record is known, so the following filter was applied:

    1. Under Column, select Name.
    2. Under Operator, select contains.

    3. Under Value, enter the record's name (aaaarecord).

      If no results appear, double-check the Filters selections and input values.

  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.

Update a specific AAAA record

Notice

This procedure updates a specific AAAA record (aaaarecord) created in an earlier procedure.

To test this function, call this API endpoint: PUT/ domains/primary/{domainId}/records/AAAA/{recordId}

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the specific record - see Path 2 for quick filtering.

  6. Select the name of the record (for example, aaaarecord) whose details you want to update.

    Alternatively, select the overflow menu (three vertical dots) at the end of the record's row, and select Edit.

  7. In the Edit Record dialog:
    1. Edit the record's details as required.

    2. Select Save to finish.

      A message appears confirming the successful update of the record.

CAA record management

Notice

In DigiCert®​​ DNS, managed domains (as seen in the UI) are referred to as primary domains in the documentation. Both terms refer to the same concept.

Overview

This guide provides detailed instructions for CAA record management, covering both targeted and comprehensive actions.

Targeted actions include:

Comprehensive actions include listing every CAA record provider.

Benefits

CAA record management safeguards against unauthorized certificate issuance, protecting domains from phishing and man-in-the-middle attacks. DigiCert®​​ DNS provides visibility and audit capabilities for rapid detection of misconfigurations, ensuring compliance with industry standards. Centralized management simplifies SSL/TLS certificate administration, reduces overhead, and promotes consistent, secure certificate practices across the organization.

Procedures

Create a CAA record

Notice

This procedure creates a CAA record (caarecord) for the primary domain domain1. The primary domain was previously created here.

To test this function, call this API endpoint: POST /domains/primary/{domainId}/records/CAA

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. Select the RECORDS tab.
  5. Select the Add Record button.
  6. In the Add Record dialog:
    1. Select CAA from the Record Type drop-down list.
    2. Enter a name in the Name field (for example, caarecord).
    3. Set the TTL value, or keep the default of 600.
    4. Select a Provider value.

    5. Select a Tag value.

      Options include issue, issuewild, iodef, issuemail, and issuevmc.

    6. Select an Issuer Critical value.

      Options include 0 (not critical) and 1 (critical).

    7. Toggle Enabled to turn the value on or off.
    8. (Optional) To add more entries, select Add Another Value.
    9. (Optional) Select Save and Add Another to add more records.

    10. Select Save and Close to finish.

      A message appears confirming the successful creation of the record.

Delete a specific CAA record

Notice

This procedure deletes a specific CAA record (caarecord) from the primary domain domain1. The primary domain and CAA record were created in earlier procedures. You can follow either Path 1 or Path 2 to complete the deletion.

To test this function, call this API endpoint: DELETE /domains/primary/{domainId}/records/CAA/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. In the RECORDS tab, locate the record you want to delete (for example, caarecord).
  5. From the overflow menu (three vertical dots) at the end of the record's row, select Delete.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. In the RECORDS tab, select the checkbox of the record you want to delete.

    Tip

    You can select multiple checkboxes to delete several records at once.

  5. Go to Actions > Delete Records.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

List CAA record providers

Notice

The current version of DigiCert®​​ DNS does not include a dedicated front-end tab for viewing all CAA record providers. To access this information, use the following endpoint:

GET /records/caa/providers

For help configuring your testing environment, refer to the API guide.

Return the details of a specific CAA record

Notice

This procedure displays the details of a specific CAA record (caarecord) created in an earlier procedure. Follow Path 1 if there are only a few results to review. Follow Path 2 if you prefer to filter results quickly.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/CAA/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the record (for example, caarecord) whose details you want to view.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table to locate the specific record quickly.

    Tip

    In this example, the name of the record is known, so the following filter was applied:

    1. Under Column, select Name.
    2. Under Operator, select contains.

    3. Under Value, enter the record's name (caarecord).

      If no results appear, double-check the Filters selections and input values.

  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.

List the CAA records of a specific primary domain

Notice

This procedure displays the CAA records of a specific primary domain (domain1). The primary domain was previously created here. You can follow either Path 1 or Path 2 to complete the retrieval.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/CAA

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table:
    1. Under Column, select Record Type.
    2. Under Operator, select contains.
    3. Under Value, enter CAA.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Toggle Group Records to group records by type.
  6. Select the CAA record drop-down list.

Update a specific CAA record

Notice

This procedure updates a specific CAA record (caarecord) created in an earlier procedure.

To test this function, call this API endpoint: PUT /domains/primary/{domainId}/records/CAA/{recordId}

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the specific record - see Path 2 for quick filtering.

  6. Select the name of the record (for example, caarecord) whose details you want to update.

    Alternatively, select the overflow menu (three vertical dots) at the end of the record's row, and select Edit.

  7. In the Edit Record dialog:
    1. Edit the record's details as required.

    2. Select Save to finish.

      A message appears confirming the successful update of the record.

CNAME record management

Notice

In DigiCert®​​ DNS, managed domains (as seen in the UI) are referred to as primary domains in the documentation. Both terms refer to the same concept.

Overview

This guide provides detailed instructions for CNAME record management, covering a series of targeted actions, including:

Benefits

CNAME record management optimizes DNS performance by routing users to the best-performing servers based on location, improving load times and user experience. With DigiCert®​​ DNS, users can simplify domain aliasing, reduce misconfigurations, and enhance performance through centralized control. The platform supports failover scenarios, minimizes redundant records, and streamlines domain mapping for greater efficiency and reliability.

Procedures

Create a CNAME record

Notice

This procedure creates a CNAME record (cnamerecord) for the primary domain domain1. The primary domain and A record were created in earlier procedures.

To test this function, call this API endpoint: POST /domains/primary/{domainId}/records/CNAME

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. Select the RECORDS tab.
  5. Select the Add Record button.
  6. In the Add Record dialog:
    1. Select CNAME from the Record Type drop-down list.
    2. Enter a name in the Name field (for example, cnamerecord).
    3. Set the TTL value, or keep the default of 600.

    4. In the Alias To field, enter the name of the record or external hostname this CNAME should point to (for example, arecord or dc.procedure.com).

      Note: The value entered must be either an existing record in your DNS zone or a syntactically valid external hostname. DigiCert®​​ DNS does not check whether an external hostname resolves — only that it is correctly formatted. If the record does not exist or the hostname is invalid, the CNAME record will not be created.

    5. (Optional) Select Save and Add Another to add more records.

    6. Select Save and Close to finish.

      A message appears confirming the successful creation of the record.

Delete a specific CNAME record

Notice

This procedure deletes a specific CNAME record (cnamerecord) from the primary domain domain1. The primary domain and CNAME record were created in earlier procedures. You can follow either Path 1 or Path 2 to complete the deletion.

To test this function, call this API endpoint: DELETE /domains/primary/{domainId}/records/CNAME/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. In the RECORDS tab, locate the record you want to delete (for example, cnamerecord).
  5. From the overflow menu (three vertical dots) at the end of the record's row, select Delete.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. In the RECORDS tab, select the checkbox of the record you want to delete.

    Tip

    You can select multiple checkboxes to delete several records at once.

  5. Go to Actions > Delete Records.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

List the CNAME records of a specific primary domain

Notice

This procedure displays the CNAME records of a specific primary domain (domain1). The primary domain was previously created here. You can follow either Path 1 or Path 2 to complete the retrieval.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/CNAME

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table:
    1. Under Column, select Record Type.
    2. Under Operator, select contains.
    3. Under Value, enter CNAME.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Toggle Group Records to group records by type.
  6. Select the CNAME record drop-down list.

Return the details of a specific CNAME record

Notice

This procedure displays the details of a specific CNAME record (cnamerecord) created in an earlier procedure. Follow Path 1 if there are only a few results to review. Follow Path 2 if you prefer to filter results quickly.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/CNAME/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the record (for example, cnamerecord) whose details you want to view.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table to locate the specific record quickly.

    Tip

    In this example, the name of the record is known, so the following filter was applied:

    1. Under Column, select Name.
    2. Under Operator, select contains.

    3. Under Value., enter the record's name (cnamerecord).

      If no results appear, double-check the Filters selections and input values.

  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.

Update a specific CNAME record

Notice

This procedure updates a specific CNAME record (cnamerecord) created in an earlier procedure.

To test this function, call this API endpoint: PUT /domains/primary/{domainId}/records/CNAME/{recordId}

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the specific record - see Path 2 for quick filtering.

  6. Select the name of the record (for example, cnamerecord) whose details you want to update.

    Alternatively, select the overflow menu (three vertical dots) at the end of the record's row, and select Edit.

  7. In the Edit Record dialog:
    1. Edit the record's details as required.

    2. Select Save to finish.

      A message appears confirming the successful update of the record.

MX record management

Notice

In DigiCert®​​ DNS, managed domains (as seen in the UI) are referred to as primary domains in the documentation. Both terms refer to the same concept.

Overview

This guide provides detailed instructions for MX record management, covering a series of targeted actions, including:

Benefits

Efficient MX record management ensures reliable email delivery and simplifies troubleshooting. Through DigiCert®​​ DNS, users can enhance redundancy, reduce latency, and strengthen protection against spam, phishing, and spoofing. Centralized management accelerates configuration updates, supports compliance with email policies, and saves administrators time, improving both security and communication reliability.

Procedures

Create an MX record

Notice

This procedure creates an MX record (mxrecord) for the primary domain domain1. The primary domain was previously created here.

To test this function, call this API endpoint: POST /domains/primary/{domainId}/records/MX

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. Select the RECORDS tab.
  5. Select the Add Record button.
  6. In the Add Record dialog:
    1. Select MX from the Record Type drop-down list.
    2. Enter a name in the Name field (for example, mxrecord).
    3. Set the TTL value, or keep the default of 600.

    4. Enter a valid server in the Server field.

      To add more entries, select Add Another Mail Server.

    5. Enter a Priority value between 0 and 65,535.
    6. (Optional) Select Save and Add Another to add more records.

    7. Select Save and Close to finish.

      A message appears confirming the successful creation of the record.

Delete a specific MX record

Notice

This procedure deletes a specific MX record (mxrecord) from the primary domain domain1.The primary domain and MX record were created in earlier procedures. You can follow either Path 1 or Path 2 to complete the deletion.

To test this function, call this API endpoint: DELETE /domains/primary/{domainId}/records/MX/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. In the RECORDS tab, locate the record you want to delete (for example, mxrecord).
  5. From the overflow menu (three vertical dots) at the end of the record's row, select Delete.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. In the RECORDS tab, select the checkbox of the record you want to delete.

    Tip

    You can select multiple checkboxes to delete several records at once.

  5. Go to Actions > Delete Records.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

List the MX records of a specific primary domain

Notice

This procedure displays the MX records of a specific primary domain (domain1). The primary domain was previously created here. You can follow either Path 1 or Path 2 to complete the retrieval.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/MX

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table:
    1. Under Column, select Record Type.
    2. Under Operator, select contains.
    3. Under Value, enter MX.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Toggle Group Records to group records by type.
  6. Select the MX record drop-down list.

Return the details of a specific MX record

Notice

This procedure displays the details of a specific MX record (mxrecord) created in an earlier procedure. Follow Path 1 if there are only a few results to review. Follow Path 2 if you prefer to filter results quickly.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/MX/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the record (for example, mxrecord) whose details you want to view.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table to locate the specific record quickly.

    Tip

    In this example, the name of the record is known, so the following filter was applied:

    1. Under Column, select Name.
    2. Under Operator, select contains.

    3. Under Value, enter the record's name (mxrecord).

      If no results appear, double-check the Filters selections and input values.

  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.

Update a specific MX record

Notice

This procedure updates a specific MX record (mxrecord) created in an earlier procedure.

To test this function, call this API endpoint: PUT /domains/primary/{domainId}/records/MX/{recordId}

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the specific record - see Path 2 for quick filtering.

  6. Select the name of the record (for example, mxrecord) whose details you want to update.

    Alternatively, select the overflow menu (three vertical dots) at the end of the record's row, and select Edit.

  7. In the Edit Record dialog:
    1. Edit the record's details as required.

    2. Select Save to finish.

      A message appears confirming the successful update of the record.

NS record management

Notice

In DigiCert®​​ DNS, managed domains (as seen in the UI) are referred to as primary domains in the documentation. Both terms refer to the same concept.

Overview

This guide provides detailed instructions for NS record management, covering a series of targeted actions, including:

Benefits

NS record management improves DNS performance by accelerating domain resolution, minimizing downtime, and automating updates across nameservers. DigiCert®​​ DNS streamlines DNS delegation, ensures consistent propagation, and reduces the risk of misconfigurations. Centralized visibility and control help maintain security, reliability, and efficient management across all domains.

Procedures

Create an NS record

Notice

This procedure creates an NS record (nsrecord) for the primary domain domain1. The primary domain was previously created here.

To test this function, call this API endpoint: POST /domains/primary/{domainId}/records/NS

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. Select the RECORDS tab.
  5. Select the Add Record button.
  6. In the Add Record dialog:
    1. Select NS from the Record Type drop-down list.
    2. Enter a name in the Name field (for example, nsrecord).
    3. Set the TTL value, or keep the default of 600.
    4. Select a GTD region, or keep the default selection of Default.

    5. Enter a valid hostname in the Hostname field.

      To add more entries, select Add Another Hostname.

    6. Toggle Enabled to turn the hostname on or off.
    7. (Optional) Select Save and Add Another to add more records.

    8. Select Save and Close to finish.

      A message appears confirming the successful creation of the record.

Delete a specific NS record

Notice

This procedure deletes a specific NS record (nsrecord) from the primary domain domain1. The primary domain and NS record were created in earlier procedures. You can follow either Path 1 or Path 2 to complete the deletion.

To test this function, call this API endpoint: DELETE /domains/primary/{domainId}/records/NS/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. In the RECORDS tab, locate the record you want to delete (for example, nsrecord).
  5. From the overflow menu (three vertical dots) at the end of the record's row, select Delete.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. In the RECORDS tab, select the checkbox of the record you want to delete.

    Tip

    You can select multiple checkboxes to delete several records at once.

  5. Go to Actions > Delete Records.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

List the NS records of a specific primary domain

Notice

This procedure displays the NS records of a specific primary domain (domain1). The primary domain was previously created here. You can follow either Path 1 or Path 2 to complete the retrieval.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/NS

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table:
    1. Under Column, select Record Type.
    2. Under Operator, select contains.
    3. Under Value, enter NS.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Toggle Group Records to group records by type.
  6. Select the NS record drop-down list.

Return the details of a specific NS record

Notice

This procedure displays the details of a specific NS record (nsrecord) created in an earlier procedure. Follow Path 1 if there are only a few results to review. Follow Path 2 if you prefer to filter results quickly.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/NS/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the record (for example, nsrecord) whose details you want to view.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table to locate the specific record quickly.

    Tip

    In this example, the name of the record is known, so the following filter was applied:

    1. Under Column, select Name.
    2. Under Operator, select contains.

    3. Under Value, enter the record's name (nsrecord).

      If no results appear, double-check the Filters selections and input values.

  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.

Update a specific NS record

Notice

This procedure updates a specific NS record (nsrecord) created in an earlier procedure.

To test this function, call this API endpoint: PUT /domains/primary/{domainId}/records/NS/{recordId}

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the specific record - see Path 2 for quick filtering.

  6. Select the name of the record (for example, nsrecord) whose details you want to update.

    Alternatively, select the overflow menu (three vertical dots) at the end of the record's row, and select Edit.

  7. In the Edit Record dialog:
    1. Edit the record's details as required.

    2. Select Save to finish.

      A message appears confirming the successful update of the record.

PTR record management

Notice

In DigiCert®​​ DNS, managed domains (as seen in the UI) are referred to as primary domains in the documentation. Both terms refer to the same concept.

Overview

This guide provides detailed instructions for PTR record management, covering a series of targeted actions, including:

Benefits

PTR record management is key to ensuring proper reverse DNS resolution, verifying IP legitimacy, and maintaining compliance with industry standards. Leveraging DigiCert®​​ DNS, users gain faster troubleshooting, enhanced debugging, and stronger security. Centralized management simplifies hostname-to-IP mapping, improves log analysis, and reduces operational complexity for a more reliable DNS environment.

Procedures

Create a PTR record

Notice

This procedure creates a PTR record (ptrrecord) for the primary domain domain1. The primary domain was previously created here.

To test this function, call this API endpoint: POST /domains/primary/{domainId}/records/PTR

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. Select the RECORDS tab.
  5. Select the Add Record button.
  6. In the Add Record dialog:
    1. Select PTR from the Record Type drop-down list.
    2. Enter a name in the Name field (for example, ptrrecord).
    3. Set the TTL value, or keep the default of 600.

    4. Enter a valid FQDN in the System field.

      To add more entries, select Add Another System.

    5. (Optional) Select Save and Add Another to add more records.

    6. Select Save and Close to finish.

      A message appears confirming the successful creation of the record.

Delete a specific PTR record

Notice

This procedure deletes a specific PTR record (ptrrecord) from the primary domain domain1. The primary domain and PTR record were created in earlier procedures. You can follow either Path 1 or Path 2 to complete the deletion.

To test this function, call this API endpoint: DELETE /domains/primary/{domainId}/records/PTR/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. In the RECORDS tab, locate the record you want to delete (for example, ptrrecord).
  5. From the overflow menu (three vertical dots) at the end of the record's row, select Delete.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. In the RECORDS tab, select the checkbox of the record you want to delete.

    Tip

    You can select multiple checkboxes to delete several records at once.

  5. Go to Actions > Delete Records.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

List the PTR records of a specific primary domain

Notice

This procedure displays the PTR records of a specific primary domain (domain1). The primary domain was previously created here. You can follow either Path 1 or Path 2 to complete the retrieval.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/PTR

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table:
    1. Under Column, select Record Type.
    2. Under Operator, select contains.
    3. Under Value, enter PTR.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Toggle Group Records to group records by type.
  6. Select the PTR record drop-down list.

Return the details of a specific PTR record

Notice

This procedure displays the details of a specific PTR record (ptrrecord) created in an earlier procedure. Follow Path 1 if there are only a few results to review. Follow Path 2 if you prefer to filter results quickly.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/PTR/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the record (for example, ptrrecord) whose details you want to view.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table to locate the specific record quickly.

    Tip

    In this example, the name of the record is known, so the following filter was applied:

    1. Under Column, select Name.
    2. Under Operator, select contains.

    3. Under Value, enter the record's name (ptrrecord).

      If no results appear, double-check the Filters selections and input values.

  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.

Update a specific PTR record

Notice

This procedure updates a specific PTR record (ptrrecord) created in an earlier procedure.

To test this function, call this API endpoint: PUT /domains/primary/{domainId}/records/PTR/{recordId}

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the specific record - see Path 2 for quick filtering.

  6. Select the name of the record (for example, ptrrecord) whose details you want to update.

    Alternatively, select the overflow menu (three vertical dots) at the end of the record's row, and select Edit.

  7. In the Edit Record dialog:
    1. Edit the record's details as required.

    2. Select Save to finish.

      A message appears confirming the successful update of the record.

SOA record configuration

Overview

This guide provides detailed instructions for SOA record management, covering both targeted and comprehensive actions.

Targeted actions include:

Comprehensive actions include clearing multiple records and listing all available records.

Benefits

SOA record management maintains DNS integrity by preventing unauthorized changes, facilitating smooth zone transfers, and ensuring rapid record propagation. DigiCert®​​ DNS streamlines troubleshooting, reduces query latency, and boosts domain resilience. Centralized control accelerates diagnostics, enhances visibility, and improves efficiency, minimizing downtime and ensuring reliable DNS operations.

Procedures

Clear multiple SOA records

Notice

This procedure clears two SOA records (soarecord1 and soarecord2) created in an earlier procedure.

To test this function, call this API endpoint: POST /soa/bulk/delete

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Configurations.
  3. In the SOA RECORDS tab, select the checkboxes next to the records you want to clear (for example, soarecord1 and soarecord2).
  4. Select Delete at the top of the table.

  5. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful clearance of the records.

Create a SOA record

Notice

This procedure creates two records: soarecord1 and soarecord2. These records are referenced in other procedures. Follow Path 1 to create the record as-is. Follow Path 2 to apply a new SOA record to a primary domain (domain1) created in an earlier procedure.

To test this function, call this API endpoint: POST /soa

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Configurations.
  3. In the SOA RECORDS tab, select the Add Record button.
  4. In the Add Record dialog:
    1. Enter a name in the Name field (for example, soarecord1).
    2. Enter a primary nameserver in the Primary Nameserver field.
    3. Enter a valid email address in the Email field.
    4. Set the TTL value.
    5. Enter a value in the Starting Serial field.
    6. Set the Refresh interval.
    7. Set the Retry interval.
    8. Set the Expiry interval.
    9. Enter a value in the Negative Cache field.

    10. Select Save to finish.

      A message appears confirming the successful creation of the record.

  5. Repeat Steps 3-4 to create another SOA record, soarecord2.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. Select the SETTINGS tab.
  5. From the SOA Record drop-down list, select Add New SOA Record.
  6. In the Add Record dialog:
    1. Enter a name in the Name field (for example, soarecord).
    2. Enter a primary nameserver in the Primary Nameserver field.
    3. Enter a valid email address in the Email field.
    4. Set the TTL value.
    5. Enter a value in the Starting Serial field.
    6. Set the Refresh interval.
    7. Set the Retry interval.
    8. Set the Expiry interval.
    9. Enter a value in the Negative Cache field.
    10. Select Save to finish.

  7. Select Save to finish.

    A message appears confirming the successful creation of the record.

  8. Repeat Steps 5-7 to create another SOA record, soarecord2.

Delete a specific SOA record

Notice

This procedure deletes a specific SOA record (soarecord) from the primary domain domain1. The primary domain and SOA record were created in earlier procedures. You can follow either Path 1 or Path 2 to complete the deletion.

To test this function, call this API endpoint: DELETE /soa/{soaId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Configurations.
  3. In the SOA RECORDS tab, at the end of the row of the SOA record you want to delete, select the trash icon.

  4. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Configurations.

  3. In the SOA RECORDS tab, select the checkbox of the record you want to delete.

    Tip

    You can select multiple checkboxes to delete several records at once.

  4. Select Delete at the top of the table.

  5. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

List all available SOA records

Notice

This procedure displays all SOA records created by the user.

To test this function, call this API endpoint: GET /soa

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Configurations.

  3. Select the SOA RECORDS tab.

    The table displays all the records associated with the account.

    Tip

    Use Columns and Filters to customize your view of the results.

Return the details of a specific SOA record

Notice

This procedure displays the details of a specific SOA record (soarecord) created in an earlier procedure. Follow Path 1 if there are only a few results to review. Follow Path 2 if you prefer to filter results quickly.

To test this function, call this API endpoint: GET /soa/{soaId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Configurations.

  3. Select the SOA RECORDS tab.

    The table displays all the records associated with the account.

  4. Locate the record (for example, soarecord) whose details you want to view.
  5. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Configurations.

  3. Select the SOA RECORDS tab.

    The table displays all the records associated with the account.

  4. Select Filters at the top of the results table to locate the specific record quickly.

    Tip

    In this example, the name of the record is known, so the following filter was applied:

    1. Under Column, select Name.
    2. Under Operator, select contains.

    3. Under Value, enter the record's name (soarecord).

      If no results appear, double-check the Filters selections and input values.

  5. Select Columns at the top of the results table, then select all checkboxes to ensure that all SOA record information is displayed.

Update a specific SOA record

Notice

This procedure updates a specific SOA record (soarecord) created in an earlier procedure.

To test this function, call this API endpoint: PUT /soa/{soaId}

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Configurations.

  3. Select the SOA RECORDS tab.

    The table displays all the SOA records associated with the account.

  4. Locate the specific record - see Path 2 for quick filtering.
  5. Select the name of the record (for example, soarecord) whose details you want to update.
  6. In the Edit Record dialog:
    1. Edit the record's details as required.

    2. Select Save to finish.

      A message appears confirming the successful update of the record.

SRV record management

Notice

In DigiCert®​​ DNS, managed domains (as seen in the UI) are referred to as primary domains in the documentation. Both terms refer to the same concept.

Overview

This guide provides detailed instructions for SRV record management, covering a series of targeted actions, including:

Benefits

SRV record management enables dynamic service discovery, efficient scaling, and faster resolution of connectivity issues. With DigiCert®​​ DNS, users can update SRV records without reconfiguring client applications, improving service availability and load balancing. Centralized management reduces administrative overhead, automates integrations, and boosts operational efficiency, allowing teams to focus on higher-priority tasks.

Procedures

Create an SRV record

Notice

This procedure creates an SRV record srvrecord) for the primary domain domain1. The primary domain was previously created here.

To test this function, call this API endpoint: POST /domains/primary/{domainId}/records/SRV

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. Select the RECORDS tab.
  5. Select the Add Record button.
  6. In the Add Record dialog:
    1. Select SRV from the Record Type drop-down list.
    2. Enter a name in the Name field (for example, srvrecord).
    3. Set the TTL value, or keep the default of 600.
    4. Enter a Priority value between 0 and 65,535.
    5. Enter a Weight value between 0 and 65,535.
    6. Enter a Port value between 0 and 65,535.
    7. Enter a valid host address in the Host field.
    8. (Optional) To add more entries, select Add Another Service.
    9. (Optional) Select Save and Add Another to add more records.

    10. Select Save and Close to finish.

      A message appears confirming the successful creation of the record.

Delete a specific SRV record

Notice

This procedure deletes a specific SRV record (srvrecord) from the primary domain domain1. The primary domain and SRV record were created in earlier procedures. You can follow either Path 1 or Path 2 to complete the deletion.

To test this function, call this API endpoint: DELETE /domains/primary/{domainId}/records/SRV/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. In the RECORDS tab, locate the record you want to delete (for example, srvrecord).
  5. From the overflow menu (three vertical dots) at the end of the record's row, select Delete.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. In the RECORDS tab, select the checkbox of the record you want to delete.

    Tip

    You can select multiple checkboxes to delete several records at once.

  5. Go to Actions > Delete Records.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

List the SRV records of a specific primary domain

Notice

This procedure displays the SRV records of a specific primary domain (domain1). The primary domain was previously created here. You can follow either Path 1 or Path 2 to complete the retrieval.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/SRV

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table:
    1. Under Column, select Record Type.
    2. Under Operator, select contains.
    3. Under Value, enter SRV.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Toggle Group Records to group records by type.
  6. Select the SRV record drop-down list.

Return the details of a specific SRV record

Notice

This procedure displays the details of a specific SRV record (srvrecord) created in an earlier procedure. Follow Path 1 if there are only a few results to review. Follow Path 2 if you prefer to filter results quickly.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/SRV/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the record (for example, srvrecord) whose details you want to view.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table to locate the specific record quickly.

    Tip

    In this example, the name of the record is known, so the following filter was applied:

    1. Under Column, select Name.
    2. Under Operator, select contains.

    3. Under Value, enter the record's name (srvrecord).

      If no results appear, double-check the Filters selections and input values.

  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.

Update a specific SRV record

Notice

This procedure updates a specific SRV record (srvrecord) created in an earlier procedure.

To test this function, call this API endpoint: PUT /domains/primary/{domainId}/records/SRV/{recordId}

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the specific record - see Path 2 for quick filtering.

  6. Select the name of the record (for example, srvrecord) whose details you want to update.

    Alternatively, select the overflow menu (three vertical dots) at the end of the record's row, and select Edit.

  7. In the Edit Record dialog:
    1. Edit the record's details as required.

    2. Select Save to finish.

      A message appears confirming the successful update of the record.

TXT record management

Notice

In DigiCert®​​ DNS, managed domains (as seen in the UI) are referred to as primary domains in the documentation. Both terms refer to the same concept.

Overview

This guide provides detailed instructions for TXT record management, covering a series of targeted actions, including:

Benefits

TXT record management strengthens DNS security and email integrity by supporting SPF, DKIM, and DMARC configurations to prevent spoofing and phishing. Through DigiCert®​​ DNS, organizations gain scalable, flexible control over multiple domains, improving authentication and monitoring. Centralized management enforces security policies consistently, reduces manual effort, minimizes configuration errors, and ensures reliable protection across all domains.

Procedures

Create a TXT record

Notice

This procedure creates a TXT record (txtrecord) for the primary domain domain1. The primary domain was previously created here.

To test this function, call this API endpoint: POST /domains/primary/{domainId}/records/TXT

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. Select the RECORDS tab.
  5. Select the Add Record button.
  6. In the Add Record dialog:
    1. Select TXT from the Record Type drop-down list.
    2. Enter a name in the Name field (for example, txtrecord).
    3. Set the TTL value, or keep the default of 600.
    4. Select a GTD region, or keep the default selection of Default.

    5. Select a Syntax value.

      Options include Generic, SPF, DKIM, DMARC, and BIMI.

    6. Enter a valid value in the Value field.

      To add more entries, select Add Another Value.

    7. (Optional) Select Save and Add Another to add more records.

    8. Select Save and Close to finish.

      A message appears confirming the successful creation of the record.

Delete a specific TXT record

Notice

This procedure deletes a specific TXT record (txtrecord) from the primary domain domain1. The primary domain and TXT record were created in earlier procedures. You can follow either Path 1 or Path 2 to complete the deletion.

To test this function, call this API endpoint: DELETE /domains/primary/{domainId}/records/TXT/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).
  4. In the RECORDS tab, locate the record you want to delete (for example, txtrecord).
  5. From the overflow menu (three vertical dots) at the end of the record's row, select Delete.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. In the RECORDS tab, select the checkbox of the record you want to delete.

    Tip

    You can select multiple checkboxes to delete several records at once.

  5. Go to Actions > Delete Records.

  6. In the Confirm Deletion dialog, select Confirm.

    A message appears confirming the successful deletion of the record.

List the TXT records of a specific primary domain

Notice

This procedure displays the TXT records of a specific primary domain (domain1). The primary domain was previously created here. You can follow either Path 1 or Path 2 to complete the retrieval.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/TXT

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table:
    1. Under Column, select Record Type.
    2. Under Operator, select contains.
    3. Under Value, enter TXT.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Toggle Group Records to group records by type.
  6. Select the TXT record drop-down list.

Return the details of a specific TXT record

Notice

This procedure displays the details of a specific TXT record (txtrecord) created in an earlier procedure. Follow Path 1 if there are only a few results to review. Follow Path 2 if you prefer to filter results quickly.

To test this function, call this API endpoint: GET /domains/primary/{domainId}/records/TXT/{recordId}

Path 1

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the record (for example, txtrecord) whose details you want to view.
  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.
Path 2

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Select Filters at the top of the results table to locate the specific record quickly.

    Tip

    In this example, the name of the record is known, so the following filter was applied:

    1. Under Column, select Name.
    2. Under Operator, select contains.

    3. Under Value, enter the record's name (txtrecord).

      If no results appear, double-check the Filters selections and input values.

  6. Select Columns at the top of the results table, then select all checkboxes to ensure that all record information is displayed.

Update a specific TXT record

Notice

This procedure updates a specific TXT record (txtrecord) created in an earlier procedure.

To test this function, call this API endpoint: PUT /domains/primary/{domainId}/records/TXT/{recordId}

  1. Sign in to your DigiCert®​​ DNS account.
  2. From the landing page, go to the left sidebar and select DNS > Domains.
  3. In the MANAGED DNS tab, select the relevant domain (for example, domain1).

  4. Select the RECORDS tab.

    The table displays all the records associated with the domain.

  5. Locate the specific record - see Path 2 for quick filtering.

  6. Select the name of the record (for example, txtrecord) whose details you want to update.

    Alternatively, select the overflow menu (three vertical dots) at the end of the record's row, and select Edit.

  7. In the Edit Record dialog:
    1. Edit the record's details as required.

    2. Select Save to finish.

      A message appears confirming the successful update of the record.