Skip to main content
Provision identity channels for an agent. Email, phone, and virtual card are all optional — omit any or all to create a shell identity. Tool name: create_agent_identity

​
Parameters

​
agentId
string
required
A unique identifier for the agent. Must match the ID used in initialize_vault.
​
intent
object
required
Describes why this tool is being called.
​
email
object
Omit to provision the agent without an email address.
​
phone
object
Omit to provision the agent without a phone number.
​
virtualCard
object
Omit to provision the agent without a virtual card.

​
Response

​
emailAddress
string
The provisioned email address, if requested.
​
emailId
string
The inbox ID at the email provider, if requested.
​
phoneNumber
string
The provisioned phone number, if requested.
​
virtualCard
object
Virtual card details, if requested.
Virtual card details (pan, cvv, exp_month, exp_year) are returned only once. Save them to the vault immediately using save_secret_to_vault.

​
Example

{
  "agentId": "agent-abc123",
  "intent": {
    "message": "Provisioning full identity for web automation agent",
    "subject": "IDENTITY",
    "action": "CREATE"
  },
  "email": {
    "issuer": "agentmail",
    "username": "myagent",
    "domain": "agentmail.to",
    "displayName": "My Agent"
  },
  "phone": {
    "issuer": "agentphone"
  },
  "virtualCard": {
    "issuer": "privacy",
    "type": "SINGLE_USE"
  }
}