Twilio

Send SMS messages, make calls, and manage messaging.

Install

amodal connect twilio

Authentication

Basic auth with account credentials.

• TWILIO_ACCOUNT_SID — Account SID (used as username)
• TWILIO_AUTH_TOKEN — Auth token (used as password)

Endpoints

Messages

• GET /Messages.json — List all messages
• GET /Messages/{sid}.json — Retrieve a single message
• POST /Messages.json — Send an SMS or MMS message (confirmation)
• DELETE /Messages/{sid}.json — Delete a message (confirmation)

Calls

• GET /Calls.json — List all calls
• GET /Calls/{sid}.json — Retrieve a single call
• POST /Calls.json — Create an outbound call (confirmation)
• POST /Calls/{sid}.json — Modify a live call (confirmation)
• DELETE /Calls/{sid}.json — Delete a call record (confirmation)

Entities

• message, call

Rules

• SMS sending is rate-limited per phone number: 1 msg/sec for standard numbers, 3/sec for toll-free, 30/sec for short codes; excess messages are queued
• All phone numbers must be in E.164 format (+[country code][number], e.g., +1XXXXXXXXXX for US)
• Standard SMS is 160 characters per segment (GSM-7); Unicode is 70 characters per segment — messages exceeding one segment are split and charged per segment
• Every outbound SMS/MMS incurs a per-message charge; failed messages may still incur carrier fees depending on failure point