createContact
createContact: Create a new contact for use with domain registrations. Requires authentication. Returns the created contact including its id for assignment to domains (registerDomain registrantId). For .al domains (AKEP): registryAttributes is required, postalCode is required, state is the region not the country, no ';' in street, prefer plain ASCII. For a company use the director or contact person as first/last name, the company as organization, entityType 'Person Juridik Privat', its NIPT/VAT, and the director's ID or passport.
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": {
"firstName": "<firstName>",
"lastName": "<lastName>",
"email": "<email>",
"phone": "<phone>",
"street1": "<street1>",
"city": "<city>",
"postalCode": "<postalCode>",
"country": "<country>"
},
"name": "createContact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | City name. | |
| Yes | Contact's email address. | ||
| phone | Yes | Phone number in '+CC.number' format, e.g. '+1.5551234567'. | |
| state | No | State, province, or region, if applicable. | |
| country | Yes | Country as a 2-letter ISO 3166-1 alpha-2 code, e.g. 'US'. | |
| street1 | Yes | First street address line. | |
| street2 | No | Second street address line, if needed. | |
| lastName | Yes | Contact's last name. | |
| firstName | Yes | Contact's first name. | |
| postalCode | Yes | Postal or ZIP code. | |
| 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. | |
| organization | No | Organization or company name, if any. | |
| registryAttributes | No | Registry-specific fields. REQUIRED for .al (AKEP): entityType, doctype, docnr, and nipt for every entityType except 'Person Natyror'. Omit for other TLDs. |