iMessage numbers for AI agents. Set up an iMessage-enabled phone number and start sending messages in under a minute.
npm install -g @sendblue/cliRequires Node.js 18+.
# Create an account and get an iMessage number
sendblue setup
# Send a message
sendblue send +15551234567 'Hello from Sendblue!'Create a new Sendblue account. Walks you through email verification, company name, and adding your first contact.
# Interactive (recommended for first time)
sendblue setup
# Non-interactive (for CI/scripts)
sendblue setup --email you@example.com # sends verification code, exits
sendblue setup --email you@example.com --code 12345678 --company my-co --contact +15551234567| Flag | Description |
|---|---|
--email <email> |
Email address |
--code <code> |
8-digit verification code |
--company <name> |
Company name (lowercase, hyphens/underscores, 3-64 chars) |
--contact <number> |
First contact phone number (E.164 format) |
Log in to an existing account.
sendblue loginSend an iMessage.
sendblue send +15551234567 'Hey, your order shipped!'View recent messages.
sendblue messages
sendblue messages -n +15551234567 --limit 20
sendblue messages --inbound| Flag | Description |
|---|---|
-n, --number <number> |
Filter by contact |
-l, --limit <count> |
Number of messages (default: 10) |
--outbound |
Show only sent messages |
--inbound |
Show only received messages |
Add a contact to your account.
sendblue add-contact +15551234567List all contacts and their verification status.
Check your account status and plan.
Show current credentials and verify they're valid.
Credentials are stored in ~/.sendblue/credentials.json with 600 permissions (owner read/write only). Run sendblue whoami to see the current config path.