Skip to main content

Documentation Index

Fetch the complete documentation index at: https://orbit-docs.devotel.io/llms.txt

Use this file to discover all available pages before exploring further.

Quickstart

Step 1: Create an Account

Sign up at orbit.devotel.io/signup. The dashboard will route you to your locale-preferred URL automatically. No credit card required — verify, claim your $5 trial credit, and get moving.

Step 2: Get Your API Key

Navigate to Settings > API Keys and create a new key. Live keys are prefixed with dv_live_sk_; test keys with dv_test_sk_. Keep these server-side only.

Step 3: Send Your First Message

The same /messages/<channel> endpoint shape works across SMS, WhatsApp, Email, RCS, and Voice — pick the channel you’re integrating first.

SMS

curl -X POST https://orbit-api.devotel.io/api/v1/messages/sms \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "from": "+14155551234",
    "body": "Hello from Orbit!"
  }'

WhatsApp

curl -X POST https://orbit-api.devotel.io/api/v1/messages/whatsapp \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "type": "template",
    "template": {
      "name": "hello_world",
      "language": "en"
    }
  }'

Email

curl -X POST https://orbit-api.devotel.io/api/v1/messages/email \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "from": "hello@yourdomain.com",
    "subject": "Welcome",
    "html": "<h1>Welcome to Acme</h1>"
  }'

Voice

curl -X POST https://orbit-api.devotel.io/api/v1/voice/calls \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "from": "+14155551234",
    "agent_id": "agent_support_bot"
  }'
Replace $ORBIT_API_KEY with the key from Step 2 (or export it in your shell). Don’t paste your key directly into shared snippets.

Step 4: Check the Response

{
  "data": {
    "message_id": "msg_abc123",
    "status": "queued",
    "channel": "sms"
  },
  "meta": {
    "request_id": "req_xyz789",
    "timestamp": "2026-03-08T00:00:00Z"
  }
}
Congratulations — you’ve sent your first message with Orbit. Hook a delivery webhook next: see Webhooks.