Add Account Custom Nameserver

POST

https://api.cloudflare.com/client/v4/accounts/{identifier}/custom_ns

Last modified:2022-12-16 13:48:32

Request

Path Params

identifier

string

required

Body Params application/json

ns_name

string <hostname>

required

The FQDN of the name server.

Example:

ns1.example.com

Example

{
    "ns_name": "ns1.example.com"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts//custom_ns' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ns_name": "ns1.example.com"
}'

Responses

🟢200Add Account Custom Nameserver response

application/json

Body

allOf {2}

optional

object (api-response-single)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

object

optional

result

object (Custom NS)

optional

A single account custom nameserver.

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "dns_records": [
            {
                "type": "A",
                "value": "1.1.1.1"
            }
        ],
        "ns_name": "ns1.example.com",
        "status": "verified",
        "zone_tag": "023e105f4ecef8ad9ca31a8372d0c353"
    },
    "success": true
}

🟢200Add Account Custom Nameserver response failure

Modified at 2022-12-16 13:48:32

List Account Custom Nameservers

Get Eligible Zones for Account Custom Nameservers