Getting Started

Create an account, register a phone number, and make your first call.

1. Create an Account

Terminal

curl -X POST https://veevo.ai/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com", "password": "your_password", "companyName": "Your Company"}'

Response

{
  "account": { "id": "...", "email": "you@company.com", "status": "INACTIVE" },
  "apiKey": "rtk_abc123...",
  "token": "eyJhbG...",
  "checkoutUrl": "https://checkout.stripe.com/c/pay/...",
  "engineVoiceUrl": "https://engine.veevo.ai/voice"
}

Account starts as INACTIVE. Open the checkoutUrl in a browser to complete payment. Store the apiKey securely — it is shown only once.

2. Register a Phone Number

Terminal

curl -X POST https://veevo.ai/api/phone-numbers \
  -H "Authorization: Bearer rtk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "+15551234567",
    "onCallStartUrl": "https://your-backend.com/calls/start",
    "onCallEndUrl": "https://your-backend.com/calls/end"
  }'

Phone numbers must be US numbers in E.164 format (+1XXXXXXXXXX). Unlimited numbers per account.

3. Point Twilio at Veevo

In the Twilio console:

1. Navigate to Phone Numbers → Active Numbers

2. Select your number → Voice Configuration

3.Set “A call comes in” webhook to the engineVoiceUrl from registration

4. Select HTTP POST

4. Implement Callbacks

Build three POST endpoints on your backend. See the Callbacks guide for full details.