create_tenant
Creates an unverified HeyIdentity test tenant with a working demo client and test user, accepting the current Terms of Use on behalf of the operator running the agent. Returns endpoints, an agent token, the fixed claim page URL, the expiry time and next_steps.
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": {
"accepted_terms_version": "<accepted_terms_version>"
},
"name": "create_tenant"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| profile | No | Optional profile: Generic (default), Microsoft (Entra ID), or AzureAdB2C (one synthetic sign-in policy). | |
| display_name | No | Optional display name of the tenant. | |
| idempotency_key | No | Strongly recommended: a random secret of 32 to 128 characters from A-Z a-z 0-9 - _ (for example crypto.randomUUID()), generated once per intended tenant and kept secret like the agent token. Retrying with the same value and arguments, only if you never received the response, returns the same tenant instead of creating another. | |
| accepted_terms_version | Yes | The current Terms of Use version (see get_catalog), accepted on behalf of the operator running the agent. |