createAccount
createAccount: Create a new OSIR customer account; step 1 of onboarding, no authentication required. The contact must be the PRINCIPAL's real ICANN registrant contact (the human or business the account is for), never the AI agent itself. Sends a verification email; complete via verifyAccount with the emailed code. While PENDING_VERIFICATION the account can search, quote and fund; billable actions need ACTIVE. Calling again for a PENDING account re-sends the verification email.
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": {
"email": "<email>",
"accountType": "<accountType>",
"contact": "<contact>",
"acceptedTerms": "<acceptedTerms>",
"termsVersion": "<termsVersion>"
},
"name": "createAccount"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | Account login email; valid mailbox that receives the verification code. | ||
| contact | Yes | The principal's real ICANN registrant contact (firstName, lastName, email, phone, street1, city, country), never the AI agent itself. | |
| password | No | Optional account password; if omitted the account is agent-managed until a password is set. | |
| agentName | No | Name of the AI agent acting for the principal, recorded for the audit trail. | |
| accountType | Yes | Account type: INDIVIDUAL or ORGANIZATION. | |
| agentVendor | No | Vendor of the AI agent acting for the principal, recorded for the audit trail. | |
| termsVersion | Yes | Version of the OSIR terms the principal accepted, e.g. '2026-09'. | |
| acceptedTerms | Yes | Must be true; requires the principal's actual consent to the OSIR terms of service. | |
| principalReference | No | Principal's own reference identifying who the agent acted for, recorded for the audit trail. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| accountId | No | ||
| contactId | No | ||
| nextSteps | No | ||
| verification | No |