Get Started

Quickstart

Create a fully-provisioned AI agent identity in under 60 seconds. This guide uses the REST API directly — no SDK needed.

Get your API key

bash

export HUMIRIS_API_KEY="hum_live_xxxxxxxxxxxxxxxx"

Create an agent

POST to the agents endpoint with a slug and persona details.

bash

curl -X POST https://humiris.com/api/agents \
  -H "Authorization: Bearer $HUMIRIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "alex-sdr",
    "persona": {
      "firstName": "Alex",
      "lastName": "Rivera",
      "jobTitle": "Sales Development Rep",
      "tone": "professional"
    }
  }'

json

{
  "success": true,
  "data": {
    "id": "agt_01hx3m...",
    "name": "alex-sdr",
    "status": "active",
    "persona": {
      "displayName": "Alex Rivera",
      "jobTitle": "Sales Development Rep"
    }
  }
}

Provision an email address

bash

curl -X POST https://humiris.com/api/agents/agt_01hx3m.../email \
  -H "Authorization: Bearer $HUMIRIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address": "alex-sdr@acme.humiris.com"}'

json

{
  "success": true,
  "data": {
    "fullAddress": "alex-sdr@acme.humiris.com",
    "isPrimary": true
  }
}

Provision a phone number

bash

curl -X POST https://humiris.com/api/agents/agt_01hx3m.../phone \
  -H "Authorization: Bearer $HUMIRIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "US"}'

json

{
  "success": true,
  "data": {
    "number": "+1 (415) 555-0142",
    "country": "US",
    "provider": "humiris"
  }
}

Your agent is ready

Alex Rivera now has a real email inbox and phone number. You can send and receive messages, provision a wallet, spin up a VPS, and more.

Next steps