Skip to page content

Send Viber campaign

Send a Viber message to multiple recipients, immediately or at a scheduled time in UTC.

POSThttps://api.quantumtec.eu/v1/viber/bulk

POST: X-ApiKey headerAuthentication

Availability

Reference for published API v1 Email and Viber methods. Confirm availability for your account with your account manager.

Request body

Request body
ParameterDescription
fromstringrequiredSender name.
textstringrequiredMessage text.
buttonTextstringoptionalText shown on the link button.
buttonUrlstringoptionalURL opened by the button.
pictureUrlstringoptionalURL of the image in the message.
recipientsarrayrequiredRecipients of the campaign.
recipients[].tostringrequiredRecipient phone number, including the country code.
recipients[].messageIdstringoptionalYour message ID. Assigned automatically when omitted.
bulkIdstringoptionalYour campaign ID. Assigned automatically when omitted.
startTimestringoptionalStart time in UTC, for example 2026-09-15T10:00:00.000Z. Starts immediately when omitted.
cURL · POST
curl --request POST 'https://api.quantumtec.eu/v1/viber/bulk' \
  --header 'X-ApiKey: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
  "from": "YOUR_SENDER",
  "text": "Hello",
  "buttonText": "View details",
  "buttonUrl": "https://example.com/details",
  "pictureUrl": "https://example.com/image.png",
  "recipients": [
    {
      "to": "37250000000"
    },
    {
      "to": "37250000001"
    }
  ]
}'

Response

Response
ParameterDescription
bulkIdstringCampaign identifier.
JSON response
{
  "bulkId": "1545e7e0-ad73-1f42-831a-5345bd11d5b4"
}

Delivery reports

API v1 lists /sms/report and /sms/report/bulk in the shared reports section. It does not specify separate Email or Viber report URLs. Confirm which report method applies to your channel with your account manager.