Skip to main content
POST
/
v1
/
senders
Create Sender
curl --request POST \
  --url https://api.zavu.dev/v1/senders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "routingPolicy": "<string>",
  "channels": {
    "channels.sms": {
      "channels.sms.phoneNumber": "<string>",
      "channels.sms.messagingServiceSid": "<string>"
    },
    "channels.whatsapp": {
      "channels.whatsapp.phoneNumber": "<string>",
      "channels.whatsapp.businessId": "<string>"
    }
  },
  "setAsDefault": true
}'
{
  "id": "snd_abc123",
  "name": "Transactional",
  "routingPolicy": "prefer_sms",
  "channels": {
    "sms": {
      "phoneNumber": "+15551234567"
    }
  },
  "isDefault": true,
  "createdAt": "2024-01-15T10:00:00.000Z",
  "updatedAt": "2024-01-15T10:00:00.000Z"
}
Create a new sender configuration with phone numbers and routing policy.

​
Request

​
name
string
required
Display name for the sender (e.g., “Transactional”, “Marketing”)
​
routingPolicy
string
default:"auto"
How to route messages: auto, prefer_sms, prefer_whatsapp, prefer_telegram
​
channels
object
required
Channel configurations
​
setAsDefault
boolean
default:"false"
Make this the default sender for the project

​
Response

{
  "id": "snd_abc123",
  "name": "Transactional",
  "routingPolicy": "prefer_sms",
  "channels": {
    "sms": {
      "phoneNumber": "+15551234567"
    }
  },
  "isDefault": true,
  "createdAt": "2024-01-15T10:00:00.000Z",
  "updatedAt": "2024-01-15T10:00:00.000Z"
}

​
Example

curl -X POST https://api.zavu.dev/v1/senders \
  -H "Authorization: Bearer zv_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Transactional",
    "routingPolicy": "prefer_sms",
    "channels": {
      "sms": {
        "phoneNumber": "+15551234567"
      },
      "whatsapp": {
        "phoneNumber": "+15551234567"
      }
    },
    "setAsDefault": true
  }'

​
Routing Policies

PolicyBehavior
autoZavu selects the best channel based on cost, deliverability, and contact preferences
prefer_smsUse SMS when available, fall back to other channels
prefer_whatsappUse WhatsApp when available, fall back to other channels
prefer_telegramUse Telegram when available, fall back to other channels