MSDHost Cloud developer docs
Everything you can do in the console you can also do from your own app. This page has the quickstarts; each one is a few lines you can paste.
Get started
- Open your account (every plan starts with a 14-day free trial).
- In the console, go to API keys and create a key. Keep it secret, like a password. (Don't see API keys? Choose Add services → Developer tools and we switch them on.)
- Send it with every request as a bearer token. The base address is
https://msdhost.net.
curl https://msdhost.net/v1/assistants \
-H "Authorization: Bearer YOUR_API_KEY"
Every answer is JSON. A key belongs to one project, so each request works on that project's agents, numbers and calendar.
AI agents
Create and train agents in the console (My agent), then read what they did from your app.
| What | Request |
|---|---|
| Your agents | GET /v1/assistants |
| Calls and chats, with transcripts and summaries | GET /v1/assistants/conversations |
| Messages and call-backs your agent took | GET /v1/assistants/notes?status=new |
| Have the agent call someone back, or remind them of an appointment | POST /v1/assistants/{agent_id}/calls |
curl -X POST https://msdhost.net/v1/assistants/AGENT_ID/calls \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"to": "+13125550100", "purpose": "callback"}'
Booking
Set your hours and services in the console (Appointments). Your agent books by phone, WhatsApp, text and website chat; you can also book from your own app.
| What | Request |
|---|---|
| Free times | GET /v1/booking/slots?date=2026-11-03&days=7 |
| Book | POST /v1/booking/appointments {"start":"2026-11-03T10:00","service":"Consultation","name":"Mary","phone":"+13125550100"} |
| Upcoming appointments | GET /v1/booking/appointments |
| Move or cancel | POST /v1/booking/appointments/{id}/move {"start":"..."} · POST /v1/booking/appointments/{id}/cancel |
Times are in your business's time zone. Each change is emailed to you and appears in your Google Calendar if you connected it.
Texts & WhatsApp
curl -X POST https://msdhost.net/v1/messages \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"from": "+13125550111", "to": "+13125550100", "text": "Your order is ready."}'
from is one of your numbers (GET /v1/numbers). Add "channel": "whatsapp" to send from your WhatsApp number, and "media_urls": ["https://..."] to send a picture. Texts to US numbers need your business texting registration, which you complete in the console.
Number Lookup
curl https://msdhost.net/v1/lookup/+13125550100 \
-H "Authorization: Bearer YOUR_API_KEY"
{"number": "+13125550100", "country": "US", "line_type": "mobile", "carrier": "...", "can_text": true}
Add ?caller_name=true for the registered caller name. $0.01 per lookup, $0.02 with caller name.
Verify
Send a one-time code to confirm a phone number belongs to your customer. Codes last 10 minutes.
curl -X POST https://msdhost.net/v1/verify \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"to": "+13125550100", "channel": "sms"}'
curl -X POST https://msdhost.net/v1/verify/check \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"to": "+13125550100", "code": "123456"}'
# -> {"to": "+13125550100", "valid": true}
"channel": "call" reads the code out in a voice call. $0.08 by text, $0.10 by call. US and Canada numbers.
Move your number here
Keep the number your customers already know. Moving it costs nothing extra; once it arrives it counts as one of your plan's numbers and your agent answers it. US and Canada numbers. Most moves take 1 to 2 weeks, and the number keeps working with your old carrier until the move day. You can do all of this in the console (Phone & Messaging → Move your existing number here), or from your app:
| What | Request |
|---|---|
| Can it move? | POST /v1/numbers/ports/check {"phone_numbers":["+13125550100"]} |
| Start a move | POST /v1/numbers/ports with the details from your phone bill (below) |
| The authorization form to sign (PDF) | GET /v1/numbers/ports/{id}/loa |
| Add the signed form or a recent bill | POST /v1/numbers/ports/{id}/documents {"kind":"loa" or "bill","filename":"...","content_base64":"..."} (PDF, PNG or JPG, up to 10 MB) |
| Correct a detail | POST /v1/numbers/ports/{id}/details (only the fields that change) |
| Send it / cancel it | POST /v1/numbers/ports/{id}/submit · POST /v1/numbers/ports/{id}/cancel |
| Where it stands | GET /v1/numbers/ports · GET /v1/numbers/ports/{id} |
curl -X POST https://msdhost.net/v1/numbers/ports \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"phone_numbers": ["+13125550100"], "business_name": "Acme Dental", "authorized_person": "Mary Smith",
"account_number": "123456789", "pin": "1234", "street": "100 Main St", "city": "Chicago",
"state": "IL", "zip": "60602"}'
Enter the details exactly as they appear on your phone bill; a mismatch is the most common reason a move is rejected. If some numbers on the account stay with the old carrier, add "all_numbers": false. The PIN is passed to the carrier and never stored. We email you when the move date is confirmed, if anything needs fixing, and when it is done.
Realtime voice & video
MSDHost Cloud rooms work with LiveKit's open-source client SDKs (web, iOS, Android, Flutter, React Native, Unity), so you can build voice and video into your app with the SDK you already know.
1. Create a room and a token (on your server)
curl -X POST https://msdhost.net/v1/rooms \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"room_name": "support-call"}'
curl -X POST https://msdhost.net/v1/participant-tokens \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"room_name": "support-call", "identity": "customer-42", "name": "Mary"}'
# -> {"token": "...", "ws_url": "wss://...", ...}
2. Join from the browser (or any LiveKit client SDK)
import { Room } from "livekit-client";
const room = new Room();
await room.connect(ws_url, token); // from step 1
await room.localParticipant.setMicrophoneEnabled(true);
Recordings, live streams, ingress and webhooks are in the console under Realtime. Projects that use LiveKit's server SDKs can get their own realtime key and address from the console (Realtime Endpoint).
Errors & limits
| Status | Meaning |
|---|---|
| 400 | Something in the request isn't valid. message says what. |
| 401 | Missing or wrong API key. |
| 402 | No active plan (the trial ended without a card). |
| 403 | Not allowed (for example, a call without consent). |
| 429 | Too many requests; wait and try again. |
Questions? Email support@msdhost.net.
MSDHost Cloud Docs