Create DNS

💎

Cloudflare settings are available only for PRIME users.

Cloudflare DNS — record types (what to put in `data[]`)

For /cloudflare/dns endpoints, data[] (alias: rrdatas[]) is an array of strings.
Important: Cloudflare stores multi-value RRsets as multiple separate DNS records.
So data: ["v1", "v2"] will create/update 2 Cloudflare DNS records.

Type	What to put in `data[]`	Example
A	IPv4 address	`["203.0.113.10"]`
AAAA	IPv6 address	`["2001:db8::10"]`
CAA	`flags tag "value"`	`["0 issue \"letsencrypt.org\""]`
CNAME	target hostname (trailing dot optional)	`["target.example.com."]`
DNSKEY	Cloudflare `content` format	`["257 3 13 <publicKey>"]`
DS	`keytag algorithm digestType digest`	`["2371 13 2 9F86D081884C7D659A2FEAA0C55AD015A3BF4F1B2B0B822CD15D6C15B0F00A08"]`
HTTPS	Cloudflare `content` format	`["1 . alpn=h3,h2 ipv4hint=203.0.113.10"]`
MX	`priority host`	`["10 mx1.example.com.","20 mx2.example.com."]`
NAPTR	`order preference flags service regexp replacement`	`["100 10 \"U\" \"E2U+sip\" \"!^.*$!sip:info@example.com!\" ."]`
NS	nameserver hostname (trailing dot optional)	`["ns1.example.com.","ns2.example.com."]`
PTR	pointer target hostname (trailing dot optional)	`["ptr-target.example.com."]`
SMIMEA	Cloudflare `content` format	`["3 1 1 <hex>"]`
SPF	(legacy) SPF string	`["v=spf1 include:_spf.google.com ~all"]`
SRV	`priority weight port target`	`["10 5 5060 sip.example.com."]`
SSHFP	`algorithm fptype fingerprint`	`["2 1 1234567890abcdef1234567890abcdef12345678"]`
SVCB	Cloudflare `content` format	`["1 . alpn=h3"]`
TLSA	`usage selector matchingType certificateAssociationData`	`["3 1 1 9F86D081884C7D659A2FEAA0C55AD015A3BF4F1B2B0B822CD15D6C15B0F00A08"]`
TXT	any text string	`["google-site-verification=xxxxxxxxxxxxxxxxxxxx"]`
URI	`priority weight target`	`["10 1 https://example.com/path"]`
Other Cloudflare types	Put exactly what Cloudflare expects in `content`	`["<cloudflare-content-format>"]`

Rules / Notes

Hostnames (CNAME/MX/SRV/NS/PTR): you may send a trailing dot (example.com.) — API will normalize it for Cloudflare.

SRV record name: name must start with _service._proto (e.g. _sip._tcp).
Example: name="_sip._tcp" or name="_sip._tcp.www".

proxied: supported only for A, AAAA, CNAME (Cloudflare limitation).

System records: SOA and apex NS (name=@) cannot be modified via API.

Access: Cloudflare DNS endpoints are available only for partner_ns domains with Cloudflare enabled.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "domain": "example.cfd",
    "data": [
        {
            "name": "wws",
            "type": "A",
            "ttl": 1,
            "data": [
                "203.0.113.10"
            ],
            "proxied": true
        },
        {
            "name": "@",
            "type": "TXT",
            "ttl": 3600,
            "data": [
                "google-site-verification=xxx"
            ]
        },
        {
            "name": "@",
            "type": "MX",
            "ttl": 3600,
            "data": [
                "10 mx1.example.com",
                "20 mx2.example.com"
            ]
        }
    ]
}

Responses

🟢200Success

application/json

Body

Example

{
    "status": true,
    "result": {
        "data": [
            {
                "domain": "example.cfd",
                "status": "failed",
                "name": "wws",
                "type": "A",
                "ttl": 1,
                "error": [
                    {
                        "code": 81058,
                        "message": "An identical record already exists."
                    }
                ]
            },
            {
                "domain": "example.cfd",
                "status": "completed",
                "name": "rubic.cfd",
                "type": "TXT",
                "ttl": 3600,
                "proxied": false,
                "rrdatas": [
                    "google-site-verification=xxx"
                ],
                "comment": null,
                "created_on": "2026-02-10T02:00:10.508419Z",
                "modified_on": "2026-02-10T02:00:10.508419Z"
            },
            {
                "domain": "example.cfd",
                "status": "completed",
                "name": "rubic.cfd",
                "type": "MX",
                "ttl": 3600,
                "proxied": false,
                "rrdatas": [
                    "10 mx1.example.com"
                ],
                "comment": null,
                "created_on": "2026-02-10T02:00:11.892848Z",
                "modified_on": "2026-02-10T02:00:11.892848Z"
            },
            {
                "domain": "example.cfd",
                "status": "completed",
                "name": "rubic.cfd",
                "type": "MX",
                "ttl": 3600,
                "proxied": false,
                "rrdatas": [
                    "20 mx2.example.com"
                ],
                "comment": null,
                "created_on": "2026-02-10T02:00:12.70084Z",
                "modified_on": "2026-02-10T02:00:12.70084Z"
            }
        ]
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not found

🟠429Too Many Requests

🔴503Unavailable

Cloudflare DNS — record types (what to put in data[])#

Rules / Notes#

Request

Responses

Cloudflare DNS — record types (what to put in `data[]`)

Rules / Notes