API Reference

curl -X POST https://agenttext-api-production.up.railway.app/v0/signup \
  -H "Content-Type: application/json" \
  -d '{"name": "My Company", "email": "dev@company.com"}'

# → { "api_key": "atx_live_...", "organization": { "plan": "free", "credits": "$5.00" } }

curl -X POST https://agenttext-api-production.up.railway.app/v0/inboxes \
  -H "Authorization: Bearer atx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"display_name": "My Agent", "area_code": "415"}'

# → { "inbox_id": "...", "phone_number": "+14155550142", "status": "active" }

# Send
curl -X POST https://agenttext-api-production.up.railway.app/v0/inboxes/{inbox_id}/messages \
  -H "Authorization: Bearer atx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to": "+15551234567", "body": "Verify my account"}'

# Wait for reply (long-poll)
curl -X POST https://agenttext-api-production.up.railway.app/v0/inboxes/{inbox_id}/wait \
  -H "Authorization: Bearer atx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"timeout": 60, "category": "otp"}'

# → { "message": { "body": "Your code is 847291", "otp_code": "847291", "category": "otp" } }

Authorization: Bearer atx_live_xxxxxxxxxxxx

# Request
{
  "name": "My Company",
  "email": "dev@company.com"
}

# Response 201
{
  "organization": {
    "id": "...",
    "name": "My Company",
    "email": "dev@company.com",
    "plan": "free",
    "credits": "$5.00"
  },
  "api_key": "atx_live_xxxxxxxxxxxx",
  "message": "Save this API key — it will not be shown again."
}

# Request
{
  "display_name": "OTP Verifier",    // optional
  "area_code": "415",                 // optional, preferred US area code
  "labels": ["monitoring"]            // optional
}

# Response 201
{
  "inbox_id": "...",
  "phone_number": "+14155550142",
  "display_name": "OTP Verifier",
  "status": "active",
  "labels": ["monitoring"],
  "message_count": 0,
  "created_at": "2026-04-13T00:00:00Z",
  "updated_at": "2026-04-13T00:00:00Z"
}

# Request
{
  "to": "+15551234567",       // E.164 format
  "body": "Verify my account",
  "labels": ["outreach"]      // optional
}

# Response 201
{
  "message_id": "...",
  "inbox_id": "...",
  "conversation_id": "...",
  "direction": "outbound",
  "from_number": "+14155550142",
  "to_number": "+15551234567",
  "body": "Verify my account",
  "status": "queued",
  "segments": 1,
  "created_at": "2026-04-13T00:00:00Z"
}

{
  "message_id": "...",
  "direction": "inbound",
  "body": "Your verification code is 847291. It expires in 10 minutes.",
  "status": "received",
  "category": "otp",
  "otp_code": "847291",
  "sender_name": "Stripe",
  "links": [],
  "opt_out_detected": false,
  "labels": ["unread"],
  "segments": 1
}

# Request
{
  "timeout": 60,           // max seconds to wait (default 60)
  "category": "otp",       // optional filter
  "since": "2026-04-13T00:00:00Z"  // optional, only messages after this time
}

# Response 200 (message arrives)
{
  "message": {
    "message_id": "...",
    "body": "Your code is 847291",
    "otp_code": "847291",
    "category": "otp",
    "created_at": "2026-04-13T00:00:45Z"
  }
}

# Response 408 (timeout)
{
  "error": "timeout",
  "message": "No matching message received within 60 seconds"
}

# Request
{
  "plan": "builder"    // "builder" ($29/mo) or "scale" ($149/mo)
}

# Response 200
{
  "checkout_url": "https://checkout.stripe.com/..."
}

npx agenttext-mcp

{
  "mcpServers": {
    "agenttext": {
      "command": "npx",
      "args": ["-y", "agenttext-mcp"],
      "env": {
        "AGENTTEXT_API_KEY": "atx_live_..."
      }
    }
  }
}