Skip to main content
All SMS commands operate against your AWS account using the credentials in your environment.
New AWS accounts start in SMS sandbox mode. Use wraps sms verify-number to add destination numbers for testing before requesting production access.

wraps sms init

Deploy SMS infrastructure (AWS End User Messaging phone number, EventBridge, DynamoDB, Lambda) to your AWS account.
wraps sms init
npx @wraps.dev/cli sms init

# Non-interactive with preset
wraps sms init --provider vercel --region us-east-1 --preset production --yes
-p, --provider
string
Hosting provider for your application. Accepted values: vercel, aws, railway, other. Determines how IAM roles and OIDC are configured.
-r, --region
string
AWS region to deploy infrastructure into. Defaults to your configured AWS region.
--preset
string
Configuration preset. Accepted values: starter, production, enterprise, custom.
PresetEst. costFeatures
starter~$1/moSimulator phone number, basic tracking
production~$2–10/moToll-free number, event tracking, message history
enterprise~$10–50/moFull features, link tracking, 1-year history
customvariesConfigure each feature individually
-y, --yes
boolean
Skip confirmation prompts and deploy immediately.

wraps sms status

Display the current state of your SMS infrastructure — phone number, configuration set, region, and resource ARNs.
wraps sms status
wraps sms status --account 123456789012
--account
string
AWS account ID to look up. Defaults to the account resolved from your current credentials.

wraps sms test

Send a test SMS message to verify your infrastructure is working.
wraps sms test --to +14155551234 --message "Hello from Wraps!"
In sandbox mode, the destination number must be verified first with wraps sms verify-number.
--to
string
Destination phone number in E.164 format (e.g., +14155551234).
--message
string
Text content of the message to send.

wraps sms verify-number

Manage verified destination phone numbers for sandbox testing. In sandbox mode, you can only send to numbers you have verified.
# Start verification for a number (sends SMS code)
wraps sms verify-number --phoneNumber +14155551234

# Submit the verification code
wraps sms verify-number --phoneNumber +14155551234 --code 123456

# List all verified numbers
wraps sms verify-number --list

# Delete a verified number
wraps sms verify-number --phoneNumber +14155551234 --delete

# Resend the verification code
wraps sms verify-number --phoneNumber +14155551234 --resend
--phoneNumber
string
Phone number to verify, in E.164 format (e.g., +14155551234).
--code
string
Verification code received via SMS. Provide this to complete verification.
--list
boolean
List all currently verified destination phone numbers.
--delete
boolean
Remove a verified number. Use with --phoneNumber.
--resend
boolean
Resend the verification SMS to the specified number.

wraps sms upgrade

Add features to an existing SMS deployment without redeploying from scratch.
wraps sms upgrade
wraps sms upgrade --region us-east-1 --yes
-r, --region
string
AWS region of the deployment to upgrade.
-y, --yes
boolean
Skip confirmation prompts.

wraps sms register

Submit toll-free number registration with AWS. Required before sending production SMS from a toll-free number. Registration typically takes up to 15 business days.
wraps sms register
wraps sms register --region us-east-1
Toll-free registration is required by carriers before you can send to most destinations. Messages sent from an unregistered toll-free number may be filtered or blocked.
-r, --region
string
AWS region of the SMS deployment.

wraps sms sync

Sync infrastructure state with the current configuration. Use this to retry failed SDK resource creation (phone pools, event destinations, protect configuration) after an interrupted init.
wraps sms sync
wraps sms sync --region us-east-1 --yes
-r, --region
string
AWS region of the deployment to sync.
-y, --yes
boolean
Skip confirmation prompts.

wraps sms destroy

Remove all SMS infrastructure deployed by Wraps from your AWS account.
wraps sms destroy
wraps sms destroy --force
wraps sms destroy --preview
This is irreversible. Phone numbers, configuration sets, DynamoDB history tables, and Lambda functions created by Wraps will be deleted.
-f, --force
boolean
Skip the confirmation prompt.
--preview
boolean
Show which resources would be deleted without deleting them.

Build docs developers (and LLMs) love