@deploybaseline/twilio

Twilio API emulator for local development and tests: accounts, API keys, phone numbers, Programmable Messaging, Messaging Services, Verify, Voice, Conversations, signed webhooks, a simulator, and an inspector.

Part of Baseline: local drop-in replacement services for CI and no-network sandboxes.

Usage

npx @deploybaseline/cli start --service twilio

In tests:

import { createEmulator } from "@deploybaseline/cli";

const twilio = await createEmulator({ service: "twilio" });
// Point the Twilio SDK at twilio.url with a request client that rewrites
// api.twilio.com, messaging.twilio.com, verify.twilio.com, and
// conversations.twilio.com to the emulator's /2010-04-01, /messaging,
// /verify, and /conversations prefixes.
await twilio.close();

Default local credentials:

TWILIO_ACCOUNT_SID=AC00000000000000000000000000000000
TWILIO_AUTH_TOKEN=twilio_test_auth_token
TWILIO_PHONE_NUMBER=+15551234567
TWILIO_VERIFY_SERVICE_SID=VA00000000000000000000000000000000

The seeded Verify Service accepts code 123456. No real SMS, voice, carrier, compliance, billing, or SendGrid traffic is performed.

Documentation

• Twilio docs: routes, Conversations, test credentials and magic numbers, the SMS and OTP simulator, seed config, and current limits
• API reference: http://localhost:3999/docs/twilio while the CLI runs (how it works)

License

Apache-2.0