registerDomain
registerDomain: Stage registration of a new domain name. Deducts from account balance. The DNS zone is initialised automatically after registration (asynchronously; if createDnsRecord right after registration reports a missing zone, retry after a few seconds). Pass initializeDnsZone:false to opt out. Returns an actionId: present the summary to the user, then call executeConfirmedAction with the actionId if they approve. Owner: pass registrantId (a saved contact from createContact/listContacts) or an inline registrantInfo. For .al domains: first createContact with registryAttributes (see its schema), then pass the returned id as registrantId; ask the user for nameservers rather than guessing. A .al domain ends in pendingCreate until the registry (AKEP) approves it by hand - that is success, not a failure.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domain": "<domain>",
"years": "<years>",
"nameservers": "<nameservers>"
},
"name": "registerDomain"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| years | Yes | Registration period in years, 1-10. | |
| domain | Yes | Fully qualified domain name to register, like "example.com", without scheme. | |
| autoRenew | No | Enable automatic renewal; defaults to true. | |
| sessionKey | No | Session key (osk_...) returned by checkDeviceLoginStatus. Pass it on every call when logged in via the in-chat device flow; omit when connected via OAuth. | |
| nameservers | Yes | List of nameserver hostnames, e.g. ["ns1.example.com", "ns2.example.com"]. | |
| registrantId | No | id of a saved contact (createContact/listContacts) to use as registrant, and as admin/tech/billing contact. REQUIRED for .al: without it the account's default contact becomes the registrant. | |
| registrantInfo | No | Inline registrant contact of the domain owner: firstName, lastName, email, phone (+CC.number), and address (street, city, postalCode, country as 2-letter ISO code). Omit when passing registrantId. Not usable for .al. | |
| initializeDnsZone | No | Initialise the DNS zone after registration; defaults to true. | |
| privacyProtection | No | Enable WHOIS privacy protection; defaults to true. | |
| registryAttributes | No | Optional per-order override of the registrant's registry fields (same shape as createContact.registryAttributes). Only for .al. |