Identity Primitives

Agent Phone

Give your AI agent a real phone number with full SMS and voice capabilities. Receive verification codes, send text messages, and make or receive phone calls with text-to-speech and speech-to-text.

How phone provisioning works

When you enable phone for an agent, Humiris provisions a real phone number from the carrier pool. The number supports both SMS and voice, and is assigned exclusively to your agent for the lifetime of the identity.

Numbers are provisioned instantly. Your agent can start sending and receiving SMS within seconds of creation.

bash

# Provision an agent with a phone number
curl -X POST https://api.humiris.com/v1/agents \
  -H "Authorization: Bearer hum_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "alex-sdr",
    "persona": {
      "firstName": "Alex",
      "lastName": "Rivera"
    },
    "identity": {
      "phone": true
    }
  }'

# Response includes the assigned number
# { "phone": "+14155550142", ... }

SMS sending and receiving

Send outbound SMS messages with a simple API call. Inbound messages are delivered to your webhook endpoint in real time, making it easy to handle verification codes, replies, and conversational SMS flows.

bash

# Send an SMS
curl -X POST https://api.humiris.com/v1/agents/alex-sdr/phone/sms/send \
  -H "Authorization: Bearer hum_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155559876",
    "body": "Hey, just confirming our meeting at 3pm today."
  }'

# List received SMS messages
curl https://api.humiris.com/v1/agents/alex-sdr/phone/sms/inbox \
  -H "Authorization: Bearer hum_sk_live_..."

Voice calls (TTS + STT)

Humiris supports outbound and inbound voice calls with integrated text-to-speech (TTS) and speech-to-text (STT). Your agent can place calls, speak with a natural voice, and understand the other party in real time.

For outbound calls, provide a script or connect your agent to a real-time conversation loop. For inbound calls, configure a webhook to receive call events and respond dynamically.

bash

# Initiate an outbound voice call
curl -X POST https://api.humiris.com/v1/agents/alex-sdr/phone/call \
  -H "Authorization: Bearer hum_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155559876",
    "voice": "nova",
    "greeting": "Hi, this is Alex from Acme. I wanted to follow up on your inquiry.",
    "webhook": "https://yourapp.com/hooks/call-events"
  }'

# The webhook receives real-time transcription events
# and your app can respond with TTS instructions

Supported countries

Humiris currently provisions phone numbers in the following countries. Additional regions are added regularly.

United States (+1)

United Kingdom (+44)

Canada (+1)

Australia (+61)

Germany (+49)

France (+33)

Netherlands (+31)

Sweden (+46)

Ireland (+353)

bash

# Provision a UK phone number
curl -X POST https://api.humiris.com/v1/agents \
  -H "Authorization: Bearer hum_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "london-agent",
    "identity": {
      "phone": { "country": "GB" }
    }
  }'

Next steps

Combine phone with Agent Email for a complete communication identity. Set up Webhooks to handle inbound SMS and call events in real time. See the API Reference for all phone endpoints.