Skip to main content
POST
/
agents
/
register
Register Agent
curl --request POST \
  --url https://api.example.com/agents/register \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "ownerName": "<string>",
  "ownerEmail": "<string>",
  "description": "<string>",
  "dailyLimit": 123,
  "webhookUrl": "<string>"
}
'

​
Request

No authentication required.
​
name
string
required
Agent name (2-100 characters).
​
ownerName
string
required
Name of the human owner (2-100 characters).
​
ownerEmail
string
required
Owner’s email address.
​
description
string
Agent description (max 500 characters).
​
dailyLimit
number
Daily spending limit. Must be positive.
​
webhookUrl
string
URL to receive real-time webhook notifications.

​
Response

{
  "agent": {
    "id": "uuid",
    "name": "MyAgent",
    "description": null,
    "ownerName": "You",
    "ownerEmail": "you@example.com",
    "status": "ACTIVE"
  },
  "wallet": {
    "id": "uuid",
    "blockchainAddress": "0x..."
  },
  "apiKey": "pp_a1b2c3d4...",
  "warning": "Save this API key — it will not be shown again.",
  "onboarding": { ... }
}
The apiKey is only returned once. Store it securely.