SMS Quickstart

Get Started with SMS

Deploy production-ready SMS infrastructure to your AWS account and send your first text message.

What you'll build

AWS End User Messaging with a provisioned phone number
Automatic opt-out management for compliance
Your first SMS sent via the TypeScript SDK

Time: ~3 minutes

Prerequisites

Before you begin, make sure you have:

Node.js 20 or later installed
An AWS account with valid credentials configured
AWS CLI installed and configured (or AWS credentials in environment variables)

1
Deploy Infrastructure

Run the Wraps CLI to deploy SMS infrastructure to your AWS account:

terminal.sh

npx @wraps.dev/cli sms init

What happens during deployment?

Validates your AWS credentials
Prompts you to choose a configuration preset (Starter, Production, or Enterprise)
Shows estimated monthly AWS costs
Provisions a toll-free number and sets up AWS End User Messaging
Deploys IAM roles for secure OIDC authentication

2
Install the TypeScript SDK

Install the @wraps.dev/sms package:

npm install @wraps.dev/sms

3
Send Your First SMS

Create a new file and send an SMS using the SDK:

send-sms.ts

import { WrapsSMS } from '@wraps.dev/sms';// Initialize the clientconst sms = new WrapsSMS();// Send an SMSconst result = await sms.send({  to: '+14155551234',  message: 'Your verification code is 123456',});console.log('SMS sent:', result.messageId);

Note: Phone Number Format

Phone numbers must be in E.164 format (e.g., +14155551234). The SDK will validate the format before sending.