Skip to main content

​
ImportDnsRecords

Import DNS records for a domain using Cloudflare’s DNS-over-HTTPS API. This resource allows you to fetch DNS records for a domain and store them in a structured format that’s compatible with DNS management functions.

​
Properties

​
domain
string
required
The domain to fetch DNS records for (e.g., “example.com”).
​
recordTypes
DnsRecordType[]
Specific record types to fetch. If not provided, defaults to all supported types.Supported types:
  • "A" - IPv4 address
  • "AAAA" - IPv6 address
  • "MX" - Mail exchange
  • "TXT" - Text record
  • "NS" - Nameserver
  • "CNAME" - Canonical name
  • "SOA" - Start of authority
  • "SRV" - Service record
  • "PTR" - Pointer record
Default: All supported types
​
bump
number
Bump the resource to force a new import. Increment this value to re-fetch DNS records.

​
Returns

​
records
DnsApiRecord[]
The DNS records as a flat array. Each record contains:
  • name: Record name
  • type: Record type
  • TTL: Time to live
  • data: Raw record data
  • content: Record content (compatible with DNS management)
  • ttl: Normalized TTL value
  • priority: Priority for MX/SRV records (optional)
​
importedAt
number
Timestamp when the records were imported.

​
Examples

​
Import all DNS records

const allRecords = await ImportDnsRecords("example.com", {
  domain: "example.com"
});

console.log(allRecords.records);
// [
//   { name: "example.com", type: "A", content: "192.0.2.1", ttl: 300, ... },
//   { name: "mail.example.com", type: "MX", content: "mail.example.com", priority: 10, ... },
//   ...
// ]

​
Import specific record types

const mailRecords = await ImportDnsRecords("example.com", {
  domain: "example.com",
  recordTypes: ["A", "MX"]
});

console.log(mailRecords.records.filter(r => r.type === "MX"));

​
Import and transfer to Cloudflare

import { Zone, DnsRecords } from "alchemy/cloudflare";

// Import DNS records from current provider
const dnsRecords = await ImportDnsRecords("dns-records", {
  domain: "example.com",
});

// Create Cloudflare zone
const zone = await Zone("example.com", {
  name: "example.com",
  type: "full",
});

// Transfer records to Cloudflare (records are directly compatible)
await DnsRecords("transfer-dns-records", {
  zoneId: zone.id,
  records: dnsRecords.records,
});

console.log(`Transferred ${dnsRecords.records.length} DNS records to Cloudflare`);

​
Force re-import with bump

// Initial import
const records1 = await ImportDnsRecords("example.com", {
  domain: "example.com",
  bump: 1
});

// Later, force a new import by incrementing bump
const records2 = await ImportDnsRecords("example.com", {
  domain: "example.com",
  bump: 2  // This will trigger a fresh fetch
});

​
DNS Record Types

The DNS utilities support the following record types:

​
A Record

Maps a domain name to an IPv4 address. 
{
  name: "example.com",
  type: "A",
  content: "192.0.2.1",
  ttl: 300
}

​
AAAA Record

Maps a domain name to an IPv6 address. 
{
  name: "example.com",
  type: "AAAA",
  content: "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
  ttl: 300
}

​
MX Record

Specifies mail servers for the domain. 
{
  name: "example.com",
  type: "MX",
  content: "mail.example.com",
  priority: 10,
  ttl: 300
}

​
CNAME Record

Creates an alias from one domain to another. 
{
  name: "www.example.com",
  type: "CNAME",
  content: "example.com",
  ttl: 300
}

​
TXT Record

Stores text information, often used for verification and policies. 
{
  name: "example.com",
  type: "TXT",
  content: "v=spf1 include:_spf.example.com ~all",
  ttl: 300
}

​
GoDaddy Utilities

Update nameservers for domains registered with GoDaddy.

​
updateNameservers

Update the nameservers for a GoDaddy domain. 
import { updateNameservers } from "alchemy/dns/godaddy";

await updateNameservers({
  domain: "example.com",
  apiKey: process.env.GODADDY_API_KEY,
  apiSecret: process.env.GODADDY_API_SECRET,
  nameservers: [
    "ns1.cloudflare.com",
    "ns2.cloudflare.com"
  ]
});
Parameters:
  • domain: Domain name to update
  • apiKey: GoDaddy API key
  • apiSecret: GoDaddy API secret
  • nameservers: Array of nameserver hostnames

Build docs developers (and LLMs) love

Get started for freeTalk to us