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>",
  "phoneNumber": "<string>",
  "setAsDefault": false,
  "webhookUrl": "<string>",
  "webhookEvents": []
}
'
{
  "id": "sender_12345",
  "name": "Primary sender",
  "phoneNumber": "+13125551212",
  "isDefault": false,
  "webhook": {
    "url": "https://api.example.com/webhooks/zavu",
    "events": [],
    "active": true,
    "secret": "whsec_abc123..."
  },
  "whatsapp": {
    "phoneNumberId": "<string>",
    "displayPhoneNumber": "+14155551234",
    "paymentStatus": {
      "setupStatus": "COMPLETE",
      "methodStatus": "VALID",
      "canSendTemplates": true
    }
  },
  "emailReceivingEnabled": false,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required
​
phoneNumber
string
required
​
setAsDefault
boolean
default:false
​
webhookUrl
string<uri>

HTTPS URL for webhook events.

​
webhookEvents
enum<string>[]

Events to subscribe to.

Type of event that triggers the webhook.

Message lifecycle events:

  • message.queued: Message created and queued for sending. data.status = queued
  • message.sent: Message accepted by the provider. data.status = sent
  • message.delivered: Message delivered to recipient. data.status = delivered
  • message.read: Message was read by the recipient (WhatsApp only). data.status = read
  • message.failed: Message failed to send. data.status = failed

Inbound events:

  • message.inbound: New message received from a contact. Reactions are delivered as message.inbound with messageType='reaction'
  • message.unsupported: Received a message type that is not supported

Broadcast events:

  • broadcast.status_changed: Broadcast status changed (pending_review, approved, rejected, sending, completed, cancelled)

Other events:

  • conversation.new: New conversation started with a contact
  • template.status_changed: WhatsApp template approval status changed

Partner events:

  • invitation.status_changed: A partner invitation status changed (pending, in_progress, completed, cancelled)

Custom domain events:

  • domain.verified: A custom email domain passed verification (DKIM, and SPF/DMARC/MAIL FROM if enhanced records are enabled)
  • domain.failed: A custom email domain failed verification or is partially verified
Available options:
message.queued,
message.sent,
message.delivered,
message.read,
message.failed,
message.inbound,
message.unsupported,
broadcast.status_changed,
conversation.new,
template.status_changed,
invitation.status_changed,
domain.verified,
domain.failed

Response

Sender created.

​
id
string
required
Example:

"sender_12345"

​
name
string
required
Example:

"Primary sender"

​
phoneNumber
string
required

Phone number in E.164 format.

Example:

"+13125551212"

​
isDefault
boolean
default:false

Whether this sender is the project's default.

​
webhook
object

Webhook configuration for the sender.

​
whatsapp
object

WhatsApp Business Account information. Only present if a WABA is connected.

​
emailReceivingEnabled
boolean
default:false

Whether inbound email receiving is enabled for this sender.

​
createdAt
string<date-time>
​
updatedAt
string<date-time>