Provision Agent Identity
provision_agentGive an AI agent a complete internet identity in one call: buy a domain, set up email, create a mailbox, and (optionally) register an authenticated webhook for inbound email. Use this when someone wants to 'give my agent a domain and email' or 'set up an agent from scratch'. Confirm the domain and price with the user first (it charges for the domain). Webhook inputs are validated before any charge; repeated calls reuse the same mailbox and webhook URL. Header values are encrypted and never returned.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Display name for outbound email. | |
| slug | No | Mailbox local part, e.g. 'hi' for hi@domain. Default 'hi'. | |
| years | No | Registration years (1-10, default 1). | |
| domain | Yes | Domain to give the agent, e.g. myagent.run. Bought if not already owned. | |
| webhook_url | No | Optional HTTPS URL to receive inbound email + domain events. | |
| payment_method | No | How to pay for the domain: card, usdc, or balance (marketplace credit). | |
| webhook_headers | No | Optional delivery auth. Only Authorization and X-API-Key are accepted; values are never returned. |