The deploy endpoint takes a business name and website and returns a live receptionist on a real phone number. Authentication is a platform API key. Keys are issued to design partners while the partner program is open. Request a key.
curl -X POST https://app.snsys.ai/api/v1/voice/deploy \ -H "Authorization: Bearer $SNSYS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"business_name": "Cedar Lane HVAC", "website_url": "https://cedarlanehvac.example"}'
{
"agent_id": "9f2c4a51-0b7e-4c2d-9e1a-1f6d8a3b5c70",
"status": "provisioning",
"status_url": "/api/v1/voice/deploy/9f2c4a51-0b7e-4c2d-9e1a-1f6d8a3b5c70"
}
The call returns 202 immediately. Provisioning runs in the background, typically about a minute. Median 49 seconds, 90th percentile 63 seconds, measured across 155 provisioned businesses, March through June 2026.
| Field | Type | Notes |
|---|---|---|
business_name | string, required | 1 to 200 characters. |
website_url | string, optional | Up to 500 characters. The source for knowledge synthesis. Include it; the agent is built from it. |
curl https://app.snsys.ai/api/v1/voice/deploy/$AGENT_ID \
-H "Authorization: Bearer $SNSYS_API_KEY"
{
"agent_id": "9f2c4a51-0b7e-4c2d-9e1a-1f6d8a3b5c70",
"status": "ready",
"phone_number": "+18605550136"
}
Poll every few seconds until status reads ready. Then call the number.
| Status | Meaning |
|---|---|
provisioning | Background build running. |
ready | Number live, agent answering. |
failed | Provisioning hit an error. Deploy again or contact us. |
| Code | Body | Meaning |
|---|---|---|
400 | invalid_payload | A detail string lists the offending fields. |
401 | missing bearer token | Missing or non-Bearer Authorization header. |
401 | invalid api key | The key did not validate. |
404 | not_found | On poll: unknown agent id, or an agent that belongs to a different organization. |
503 | authentication temporarily unavailable | Key validation briefly unreachable. Retry with backoff. |
A trial agent on a pooled phone number, built from the website: services, hours, FAQs, and voice guidance. Messages, texts, and emails work from the first call. Activation promotes the trial to a persistent agent with its own number and turns on booking and live transfers. During the partner program, activation runs through us.
SNSYS Voice ships as a tool server for the Model Context Protocol. A deploy runs from Claude Desktop, Claude Code, or Cursor with one instruction: the deploy_voice_agent tool starts the deploy, polls until ready, and returns the phone number.
{
"mcpServers": {
"snsys-voice": {
"command": "snsys-voice",
"env": {
"SNSYS_API_KEY": "sk_live_...",
"SNSYS_VOICE_BASE_URL": "https://app.snsys.ai"
}
}
}
}
The snsys-voice server package is provided during design partner onboarding.
Questions during integration go straight to the people who built the platform.