Messages Resource ASYNC

# Create (send) a message
POST /2010-04-01/Accounts/{AccountSid}/Messages.json

# Get message details
GET /2010-04-01/Accounts/{AccountSid}/Messages/{Sid}.json

# List messages
GET /2010-04-01/Accounts/{AccountSid}/Messages.json

# Update message (redact, cancel)
POST /2010-04-01/Accounts/{AccountSid}/Messages/{Sid}.json

# Delete message
DELETE /2010-04-01/Accounts/{AccountSid}/Messages/{Sid}.json

Messaging Services ASYNC

Higher-level abstraction that manages sender selection, compliance, and scaling.

# Create messaging service
POST /v1/Services

# Add phone numbers to service
POST /v1/Services/{ServiceSid}/PhoneNumbers

# Send via service (auto-selects best sender)
POST /v1/Services/{ServiceSid}/Messages

Calls Resource REAL-TIME

# Initiate outbound call
POST /2010-04-01/Accounts/{AccountSid}/Calls.json
To=+15551234567
From=+15559876543
Url=https://your-app.com/twiml/answer  # TwiML instructions

# Get call details
GET /2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json

# Modify in-progress call
POST /2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json
Status=completed  # Hang up

# List calls
GET /2010-04-01/Accounts/{AccountSid}/Calls.json

Recordings ASYNC

# List recordings for a call
GET /2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings.json

# Get recording audio
GET /2010-04-01/Accounts/{AccountSid}/Recordings/{Sid}.mp3

# Delete recording
DELETE /2010-04-01/Accounts/{AccountSid}/Recordings/{Sid}.json

Conferences REAL-TIME

# List conferences
GET /2010-04-01/Accounts/{AccountSid}/Conferences.json

# Get conference details
GET /2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}.json

# List participants
GET /2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}/Participants.json

# Kick participant
DELETE /2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}/Participants/{CallSid}.json

Rooms REAL-TIME

# Create a room
POST /v1/Rooms
UniqueName=DailyStandup
Type=group  # or peer-to-peer, group-small

# Get room details
GET /v1/Rooms/{Sid}

# Complete a room (end the meeting)
POST /v1/Rooms/{Sid}
Status=completed

# List participants in room
GET /v1/Rooms/{RoomSid}/Participants

Recordings & Compositions ASYNC

# List recordings
GET /v1/Rooms/{RoomSid}/Recordings

# Create composition (combine recordings)
POST /v1/Compositions
RoomSid=RM123...
AudioSources=*
VideoLayout={"grid":{"video_sources":["*"]}}

# Get composition status
GET /v1/Compositions/{Sid}

Verification Flow SYNC

# Step 1: Create verification service (one-time setup)
POST /v2/Services
FriendlyName=MyAppVerification
CodeLength=6

# Step 2: Start verification (sends code)
POST /v2/Services/{ServiceSid}/Verifications
To=+15551234567
Channel=sms  # or voice, email, whatsapp

Response: { "status": "pending", "sid": "VE123...", "to": "+15551234567" }

# Step 3: Check code (user submits code)
POST /v2/Services/{ServiceSid}/VerificationCheck
To=+15551234567
Code=123456

Response: { "status": "approved", "valid": true }
# or: { "status": "pending", "valid": false } if wrong code

Phone Number Intelligence SYNC

# Basic lookup (formatting, carrier)
GET /v2/PhoneNumbers/+15551234567

Response:
{
  "phone_number": "+15551234567",
  "national_format": "(555) 123-4567",
  "country_code": "US",
  "carrier": {
    "name": "Verizon",
    "type": "mobile",
    "mobile_country_code": "311",
    "mobile_network_code": "480"
  }
}

# Advanced lookup with add-ons
GET /v2/PhoneNumbers/+15551234567?Fields=line_type_intelligence,caller_name

Response includes:
  "line_type_intelligence": { "type": "mobile" },
  "caller_name": { "caller_name": "John Doe", "caller_type": "CONSUMER" }

TaskRouter API SYNC

# Create a task (customer contacts you)
POST /v1/Workspaces/{WorkspaceSid}/Tasks
Attributes={"type":"support","priority":1,"customer_id":"C123"}
WorkflowSid=WW123...

# Accept a reservation (agent picks up)
POST /v1/Workspaces/{WorkspaceSid}/Tasks/{TaskSid}/Reservations/{ReservationSid}
ReservationStatus=accepted

# Complete a task
POST /v1/Workspaces/{WorkspaceSid}/Tasks/{TaskSid}
AssignmentStatus=completed

Conversations API ASYNC

# Create conversation (omnichannel thread)
POST /v1/Conversations
FriendlyName=Support-Case-123

# Add participant (customer via SMS)
POST /v1/Conversations/{ConversationSid}/Participants
MessagingBinding.Address=+15551234567
MessagingBinding.ProxyAddress=+15559876543

# Add participant (agent via Flex UI)
POST /v1/Conversations/{ConversationSid}/Participants
Identity=agent@company.com

# Send message
POST /v1/Conversations/{ConversationSid}/Messages
Author=agent@company.com
Body=How can I help you today?

Tracking API ASYNC

# Track an event
POST https://api.segment.io/v1/track

{
  "userId": "user_123",
  "event": "Order Completed",
  "properties": {
    "orderId": "ORD-456",
    "total": 99.99,
    "currency": "USD",
    "products": [
      { "sku": "SKU-1", "name": "Widget", "price": 49.99 }
    ]
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

# Identify a user
POST https://api.segment.io/v1/identify

{
  "userId": "user_123",
  "traits": {
    "email": "john@example.com",
    "name": "John Doe",
    "plan": "enterprise",
    "company": {
      "name": "Acme Inc",
      "industry": "Technology"
    }
  }
}

Mail Send API ASYNC

# Send email (v3 API)
POST https://api.sendgrid.com/v3/mail/send

{
  "personalizations": [
    {
      "to": [{"email": "john@example.com", "name": "John Doe"}],
      "subject": "Welcome to Our Service"
    }
  ],
  "from": {"email": "noreply@company.com", "name": "Company"},
  "content": [
    {"type": "text/plain", "value": "Welcome!"},
    {"type": "text/html", "value": "
Welcome!
"}
  ],
  "tracking_settings": {
    "click_tracking": {"enable": true},
    "open_tracking": {"enable": true}
  }
}