Sandbox

​

How it works

​

Activation

1. Go to the Lines page in your dashboard
2. Scan the QR code with your phone, or copy the activation code and text it to the sandbox number
3. Once the message is received, your sandbox is activated and your phone number is paired

​

Limits

​

Sending messages

import { createClient } from "@messages-dev/sdk";

const client = createClient();

await client.sendMessage({
  from: "+15551234567",
  to: "+15559876543",
  text: "Hello from the sandbox!",
});

curl -X POST "https://api.messages.dev/v1/messages" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "+15551234567",
    "to": "+15559876543",
    "text": "Hello from the sandbox!"
  }'

​

Receiving messages

1. Go to Webhooks in the dashboard
2. Select the sandbox line and enter your endpoint URL
3. Webhooks are scoped to your account; you only receive events for your paired phone number

​

Upgrading to a dedicated line

• Set up a dedicated iMessage line with no daily limits
• See the quickstart guide for setup instructions

​

Errors