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

Authorization Bearer tokenstring

API key needed to access the endpoint

Body

labelstringrequired

The subname label

Example: ninja

domainstringrequired

The parent ENS domain name

Example: thenamespace.eth

addressstringrequired

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.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/subname/mint' \
  --header 'Content-Type: application/json' \
  --data '{"label":"ninja","domain":"thenamespace.eth","address":"0xFe89cc7aBB2C4183683ab71653C4cdc9B02D44b7","textRecords":"{\"email\": \"[email protected]\"}","dataRecords":{}}'

201

400

401

500

201

No body

Subname successfully created.