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

  1. Open your account (every plan starts with a 14-day free trial).
  2. 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.)
  3. 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.

WhatRequest
Your agentsGET /v1/assistants
Calls and chats, with transcripts and summariesGET /v1/assistants/conversations
Messages and call-backs your agent tookGET /v1/assistants/notes?status=new
Have the agent call someone back, or remind them of an appointmentPOST /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"}'
Agents only call people who contacted your business first (a call, text or message in the last 90 days) or booked an appointment with you, between 10 AM and 7 PM US Central time, and never for sales. A person who asks not to be called again is never called again.

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.

WhatRequest
Free timesGET /v1/booking/slots?date=2026-11-03&days=7
BookPOST /v1/booking/appointments  {"start":"2026-11-03T10:00","service":"Consultation","name":"Mary","phone":"+13125550100"}
Upcoming appointmentsGET /v1/booking/appointments
Move or cancelPOST /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:

WhatRequest
Can it move?POST /v1/numbers/ports/check  {"phone_numbers":["+13125550100"]}
Start a movePOST /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 billPOST /v1/numbers/ports/{id}/documents  {"kind":"loa" or "bill","filename":"...","content_base64":"..."} (PDF, PNG or JPG, up to 10 MB)
Correct a detailPOST /v1/numbers/ports/{id}/details  (only the fields that change)
Send it / cancel itPOST /v1/numbers/ports/{id}/submit  ·  POST /v1/numbers/ports/{id}/cancel
Where it standsGET /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

StatusMeaning
400Something in the request isn't valid. message says what.
401Missing or wrong API key.
402No active plan (the trial ended without a card).
403Not allowed (for example, a call without consent).
429Too many requests; wait and try again.

Questions? Email support@msdhost.net.