Skip to main content
PATCH
/
v1
/
senders
/
{senderId}
Update Sender
curl --request PATCH \
  --url https://api.zavu.dev/v1/senders/{senderId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "routingPolicy": "<string>",
  "channels": {},
  "setAsDefault": true
}'
{
  "id": "snd_abc123",
  "name": "Transactional (Updated)",
  "routingPolicy": "prefer_whatsapp",
  "channels": {
    "sms": {
      "phoneNumber": "+15551234567"
    },
    "whatsapp": {
      "phoneNumber": "+15551234567"
    }
  },
  "isDefault": true,
  "createdAt": "2024-01-15T10:00:00.000Z",
  "updatedAt": "2024-01-16T14:30:00.000Z"
}
Update the properties of an existing sender configuration.

Path Parameters

senderId
string
required
The sender identifier (e.g., snd_abc123)

Request

All fields are optional. Only provided fields will be updated.
name
string
Display name for the sender
routingPolicy
string
Routing policy: auto, prefer_sms, prefer_whatsapp, prefer_telegram
channels
object
Channel configurations (replaces existing)
setAsDefault
boolean
Make this the default sender

Response

{
  "id": "snd_abc123",
  "name": "Transactional (Updated)",
  "routingPolicy": "prefer_whatsapp",
  "channels": {
    "sms": {
      "phoneNumber": "+15551234567"
    },
    "whatsapp": {
      "phoneNumber": "+15551234567"
    }
  },
  "isDefault": true,
  "createdAt": "2024-01-15T10:00:00.000Z",
  "updatedAt": "2024-01-16T14:30:00.000Z"
}

Example

curl -X PATCH https://api.zavu.dev/v1/senders/snd_abc123 \
  -H "Authorization: Bearer zv_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "routingPolicy": "prefer_whatsapp"
  }'