Onboard an account

​

1. Create the account record

const account = await sly.accounts.create({
  type: 'business',
  name: 'Acme Robotics',
  email: 'ops@acme.example',
  metadata: { internal_id: 'cust_abc' },
});
// account.id = 'acc_...'

​

2. Start verification

const verification = await sly.accounts.startVerification(account.id, {
  provider: 'persona',              // or 'stripe_identity', 'custom'
  redirect_url: 'https://yourapp.example/kyc-complete',
});
// verification.url — where to send the user

​

3. Listen for the verified event

// Webhook payload
{
  "type": "account.verified",
  "data": {
    "account": { "id": "acc_...", "verification_status": "verified", "kyc_tier": 2 }
  }
}

​

4. Optional: on-chain identity

await sly.accounts.registerErc8004(account.id, { chain: 'base' });

​

Sandbox shortcuts

• Verification approves instantly without real documents
• Tier can be set directly: sly.accounts.update(id, { kyc_tier: 2 })
• No actual Persona calls are made

​

Common pitfalls

• Treating an unverified account as ready. Tier 0 caps are intentionally low. If your product needs higher amounts immediately, gate account creation behind verification.
• Embedding verification URLs. The verification.url is single-use and time-limited (~30 min). Don’t cache it — generate on demand.
• Forgetting to store the ID. You’ll need account.id for every downstream operation (agent creation, wallet creation, transfers).

​

Next

• Register an agent — attach an AI actor to this account
• Core concepts → Accounts — data model reference