Register your first agent

Prerequisites

Navigate to app.imarobot.ai/agents and click Register Agent.

Field	Example	Notes
Name	`PortfolioBot`	Human-readable, shows in verification responses
Issuer domain	`apexwealth.com`	Your domain — embedded in the token
Scopes	`read:portfolio, read:transactions`	Comma-separated. Free-form strings.
Description	`Reads portfolio data from Plaid`	Optional but recommended

After clicking Register, you’ll see the token exactly once. Copy it immediately — it cannot be recovered.

eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

Store it as an environment variable in your agent process:

IMAROBOT_TOKEN=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

curl https://api.imarobot.ai/v1/verify/$IMAROBOT_TOKEN

You should see:

{
  "valid": true,
  "agent_id": "agt_abc123",
  "name": "PortfolioBot",
  ...
}

Your agent should pass the token as a Bearer token when calling receiver APIs:

const response = await fetch('https://receiver-api.com/data', {
  headers: {
    'Authorization': `Bearer ${process.env.IMAROBOT_TOKEN}`,
  },
});

The receiver calls GET /v1/verify/{token} to validate it. See imarobot-verify SDK for receiver-side integration.