Dashboard →
Reference

API Reference

Base URL: https://humiris.com/api

All requests must include Authorization: Bearer YOUR_API_KEY

Agents

GET/agents

List all agents in your account.

Response
{ "success": true, "data": [{ "id": "agt_...", "name": "alex-sdr", "status": "active" }] }
POST/agents

Create a new agent with optional persona details.

Parameters
namestringrequiredUnique slug identifier (e.g. alex-sdr)
persona.firstNamestringAgent first name
persona.lastNamestringAgent last name
persona.jobTitlestringJob title shown in signatures
persona.tonestringprofessional | casual | friendly
Response
{ "success": true, "data": { "id": "agt_01hx3m...", "name": "alex-sdr", "status": "active" } }
GET/agents/:id

Get a single agent with all provisioned resources.

Response
{ "success": true, "data": { "id": "agt_...", "persona": {...}, "emailAddresses": [...], "phone": {...}, "wallet": {...} } }
DELETE/agents/:id

Delete an agent and release all associated resources.

Response
{ "success": true }

Email

POST/agents/:id/email

Provision an email address for the agent.

Parameters
addressstringrequiredFull email address (e.g. alex@acme.humiris.com)
typestringdedicated | shared (default: dedicated)
Response
{ "success": true, "data": { "fullAddress": "alex@acme.humiris.com", "isPrimary": true } }
GET/agents/:id/email

List all email addresses for the agent.

Response
{ "success": true, "data": [{ "fullAddress": "alex@acme.humiris.com", "isPrimary": true }] }

Phone

POST/agents/:id/phone

Provision a phone number for the agent.

Parameters
countrystringCountry code: US (default), GB, CA, AU
Response
{ "success": true, "data": { "number": "+1 (415) 555-0142", "country": "US" } }
DELETE/agents/:id/phone

Release the agent's phone number.

Response
{ "success": true }

Wallet

POST/agents/:id/wallet

Generate a crypto wallet for the agent.

Parameters
chainstringrequiredethereum | solana | polygon | base
Response
{ "success": true, "data": { "address": "0x7a2...f9e1", "chain": "ethereum" } }