Create a new ENS subname

POST /v1/subname/mint

To mint a new subname the following parameters are required

• domain is the full ENS name - for example, thenamespace.eth

• label is the label of requested the subname - for example, ninja in ninja.thenamespace.eth.

• address to which the subname will resolve is also required.

Error Responses

For error response body refer to the Responses section below.

POST/v1/subname/mint

Header parameters

Body

application/json

label*string

The subname label

Example: "ninja"

domain*string

The parent ENS domain name

Example: "thenamespace.eth"

address*string

Ethereum address

Example: "0xFe89cc7aBB2C4183683ab71653C4cdc9B02D44b7"

coinTypenumber

Coin type used to specify addresses on different chains (https://docs.ens.domains/ensip/9).

textRecordsobject

Text records associated with this subname

Example: "{\"email\": \"[email protected]\"}"

dataRecordsobject

Custom data associated with this subname. Can be any String or JSON object.

ttlnumber

Subname time to live, specifies when the subname records will expire.

Response

201400401500

Subname successfully created.

Request

JavaScriptCurlPython

const response = await fetch('/v1/subname/mint', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "label": "ninja",
      "domain": "thenamespace.eth",
      "address": "0xFe89cc7aBB2C4183683ab71653C4cdc9B02D44b7"
    }),
});
const data = await response.json();

Response

400500

{
  "status": 400,
  "path": "text",
  "error": [
    {
      "property": "text",
      "value": "text",
      "message": "text"
    }
  ]
}