Create DNS record
ns1_create_recordDestructiveIdempotent
WRITE: creates ONE new DNS record and CHANGES LIVE DNS for that name as soon as NS1 serves it; a wrong answer can take a site or mail offline. Plain records only (A, AAAA, ALIAS, CAA, CNAME, MX, PTR, SRV, TXT; no NS/SOA, no traffic-steering filters or metadata). Refuses when the record already exists (use ns1_update_record). Answers are lists of rdata fields: A ["192.0.2.10"], MX [10, "mail.example.com."], TXT ["v=spf1 -all"], SRV [10, 5, 5060, "sip.example.com."], CAA [0, "issue", "letsencrypt.org"]. PUT /v1/zones/{zone}/{domain}/{type}.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ttl | No | TTL in seconds. Omit for the zone default. | |
| type | Yes | Record type. | |
| zone | Yes | Zone name, e.g. example.com. | |
| domain | Yes | Full record name inside the zone, e.g. www.example.com (or the zone name itself for the apex). | |
| answers | Yes | One entry per answer, each a list of rdata fields (see the tool description). |