Quickstart

Get TextPilot running in your project in under 5 minutes.

1. Install the SDK

npm install textpilot

2. Get your API key

Sign up at textpilot.dev
Create a project in the dashboard
Generate an API key — copy it immediately (it's shown only once)

3. Send your first SMS

import { TextPilot } from 'textpilot'

const tp = new TextPilot('tp_live_abc123...')

const result = await tp.send('+16195551234', 'Hello from TextPilot!')

console.log(result)
// {
//   id: 'msg_a1b2c3d4e5f6',
//   status: 'queued',
//   to: '+16195551234',
//   createdAt: '2026-03-09T...'
// }

4. Check message status

const messages = await tp.messages.list()

for (const msg of messages.data) {
  console.log(`${msg.to}: ${msg.status}`)
}

Using the REST API directly

If you prefer raw HTTP calls over the SDK:

curl -X POST https://textpilot-api.jackrgisel.workers.dev/v1/messages \
  -H "Authorization: Bearer tp_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+16195551234",
    "message": "Hello from TextPilot!"
  }'

Environment Variables

For production, store your API key in an environment variable:

TEXTPILOT_API_KEY=tp_live_abc123...

const tp = new TextPilot(process.env.TEXTPILOT_API_KEY!)

Next Steps

SDK Reference — All SDK methods and types
API Reference — REST endpoint details
Billing — Understand plans and credits