---
title: "Send a Viber Single Message"
method: POST
path: "/viber"
---

# Send a Viber Single Message

`POST /viber`

Send Viber message to single recipient. This is a paid service.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- object
  - `senderInfoTrackingId` string, required — The unique sender id. You can find it at [Routee Platform-applications page](https://dev.routee.net/#/management/applications).
  - `to` string, required — The phone number the message is about to be sent to. Format with a '+' and country code e.g., +3069xxxxxxxx (E.164 format).
  - `body` object — The body containing the content of the message.
    - `text` string — The text of Viber message. Maximum number of characters supported in a Viber message is 1000 characters. Use [~{labelName}] in order to send personalized messages, by using the labels of your contacts. [Text only messages are billed as Transactional. All the other message types are charged as Promotional].
    - `imageURL` string — The URL of the image (recommended image size: 400KB for optimal delivery; image URL length: max 1000 characters; only valid and secure URL starting with https://).
    - `action` object
      - `caption` string — The displayed text on the button (1-30 characters).
      - `targetUrl` string — The target URL of the Viber action.
    - `viberFile` object
      - `fileName` string, required — The name of the file. Max size 25 chars.
      - `fileType` string, required — Type of Viber message file. The supported file types are following: For document: doc, .docx, .rtf, .dot, .dotx, .odt ,odf, .fodt, .txt, .info; For PDF: pdf, .xps, .pdax, .eps; For Spreadsheet: .xls, .xlsx, .ods, .fods, .csv, .xlsm, .xltx .
      - `fileURL` string, required — The URL of the document (recommended file size: 600KB for optimal delivery) (document URL length: up to 1000; only valid and secure URL starting with https://).
    - `viberVideo` object
      - `videoURL` string, required — The URL where the video is hosted (1000 max chars, only https).
      - `videoThumbnail` string, required — The URL of a thumbnail for the video (1000 max chars, only https).
      - `fileSize` integer, required — The file size in MB (positive number, 200 max).
      - `duration` integer, required — The video’s duration in seconds (positive number, 600 max).
    - `carousel` object
      - `items` object[] — List of carousel cards
        - `title` string — Short title of the card
        - `imageUrl` string — Fully qualified HTTPS image URL
        - `primaryButton` object — Carousel Primary Button
          - `label` string — carousel primary button label
          - `actionUrl` string — carousel primary button action url
        - `secondaryButton` object — Optional
          - `label` string — secondary button label
          - `actionUrl` string — secondary button action url
  - `ttl` integer — Time range until message expires. TTL range in seconds: 30 - 86400 seconds. If it is not set, the default range is 14 days.
  - `callbackUrl` string — Defines the callback URL that will receive all the individual messages' progress of the Viber campaign.
  - `inboundUrl` string — Defines the callback URL that will receive the inbound messages.
  - `label` string — A generic label which can be used for tagging the Viber message. Maximum length is 350 characters.
  - `isSessionMessage` boolean — Indicates a Viber Single is a Viber Session if the value is true. False by default. Learn more about session messaging at our [documentation](https://docs.routee.net/docs/send-a-viber-session).

## Response `200`

200

- object
  - `trackingId` string
  - `to` string
  - `from` string
  - `country` string
  - `status` object
    - `status` string
    - `date` string
  - `applicationName` string
  - `direction` string
  - `ttl` string
  - `message` string
  - `viberAction` object
    - `caption` string
    - `targetUrl` string
  - `imageUrl` string
  - `sessionMessage` boolean
  - `inboundUrl` string
  - `callbackUrl` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/routee/apis/auth.md) · [All operations](https://skmtc.net/routee/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/routee/auth/versions/5cef04e8f7d8/schema)