v1
Double column
API
CLI
JS Client
API
CLI
JS Client

POST /v1/domains

Example request

Request body

curl
curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request POST \
  --data '{"domain":"example.com"}' \
  https://api.northflank.com/v1/domains

Example response

200 OK

Details about the newly added domain.

JSON

{
  "data": {
    "name": "example.com",
    "status": "pending",
    "hostname": "nfverify1608026055",
    "token": "e596987b52855a4a773ef580ce2985d7746b37ce8b2a443d20fa27b913d8f57"
  }
}

Example response

400 Bad Request

The domain is not valid, possibly because it is too long.

Example response

409 Conflict

The domain is already registered with this account.

© 2021 Northflank Ltd. All rights reserved.