Connect DNS Records

`dnsRecords` object

DNS records can be provided in two different ways, using a single array of records or an object with the array of records specified the domain and subdomain cases.

Record object specification

Property	Type	Required?	Example
host	string	Yes	www
ttl	integer	Yes	300 (This is the minimum accepted value. Some providers don’t accept this value and will default to the minimum value allowed by the provider.)
type	string (see below)	Yes	CNAME (Check the Supported record types section below)
value	string	Yes	m.example.com
fallbackValue	string	No	v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDg9/gR+3J0mmugLjhpYOfQK9ytkEKnXM0kVdpu0UoykSPK7ChD+nRxFJbN2cxtvu8GrCNQwPTKbC0jimaSi0V2j3JndnRrECuYCqeZYcRmw2lYs18QnmJRfCpweKoaGtv9zERCkeHwLcTaLkrSHrRDf58WgERg8x/4ipBPIyZufwIDAQAB
priority	integer	Only for MX records	10
advancedDmarcOptions	object	Only for DMARC (`TXT`) records	See the full schema in DMARC Handling: Advanced Options. Lets you override, remove, or conditionally add DMARC tags, and inherit DMARC from the root domain.

`advancedDmarcOptions` (DMARC records only)

For DMARC TXT records you can attach an advancedDmarcOptions object to a record to take precise control over how Entri merges, overrides, or preserves individual DMARC tags.

Property	Type	Description
`inheritRootDmarc`	boolean	When `true` on a subdomain DMARC record, inherits the DMARC policy from the root domain.
`overrideTags`	object	Map of tag → value. Overrides the listed tags in the existing DMARC record, or adds them if missing.
`removeTags`	array	List of DMARC tag names to remove from the existing record (e.g. `["pct"]`).
`addTagsIfNotExist`	object	Map of tag → value. Adds each tag only if it is not already present on the existing DMARC record.

See DMARC Handling: Advanced Options for full examples and use cases.

Simple array

A single array of dns records. This is the easiest way to send Entri the set of records you want to configure for all on all domains with no subdomain/domain distinction.

{
  ...,
  dnsRecords: [
    {
      type: "CNAME",
      host: "shop",
      value: "myapp.com",
      ttl: 300,
    },
    {
      type: "TXT",
      host: "@",
      value: "123-example-txt-record",
      ttl: 300,
    }
  ]
}

Dynamic configuration variables

You can insert dynamic variables into the dnsRecords section of your configuration object using syntax. For example, if the user sets up blog.example.com, the following variables will be available:

Variable name	Example value
`{DOMAIN}`	example.com
`{SUBDOMAIN}`	blog
`{SLD}`	example
`{TLD}`	com
`{emailProviderSPF}`	Google

Please note, all the variables are case-sensitive and must be inputted in all upper-case.

Supported Record Types

Type	Description
A	Holds the IP address of a domain.
AAAA	The AAAA record is conceptually similar to the A record, but it allows you to specify the IPv6 address of the server, rather than the IPv4.
CNAME	Forwards one domain or subdomain to another domain. Does not provide an IP address.
CAA	Used to provide additional confirmation for the Certification Authority (CA) when validating an SSL certificate.
MX	Directs email to an email server.
TXT	Stores text strings. For special uses of the TXT record, see Handling DKIM, SPF, and DMARC records.
NS	Indicates which DNS server is authoritative for that domain, it is the server that stores all DNS records for a domain, including A records, MX records, or CNAME records.

Get Started

Entri Activate

Entri Connect

Entri Sell

Entri Power

Entri Secure

Entri Monitor

Entri Network

Entri MCP

DNS Concepts

Reference

Legal & Security

Connect DNS Records

`dnsRecords` object

Record object specification

`advancedDmarcOptions` (DMARC records only)

Simple array

Dynamic configuration variables

Supported Record Types

​dnsRecords object

​Record object specification

​advancedDmarcOptions (DMARC records only)

​Simple array

​Dynamic configuration variables

​Supported Record Types

`dnsRecords` object

Record object specification

`advancedDmarcOptions` (DMARC records only)

Simple array

Dynamic configuration variables

Supported Record Types