---
title: "Send omnimessages"
description: "Send fallback of messages via platform"
openapi: "/openapi/omni-api.yaml POST /omnimessages"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

`POST https://web.otpcod.ru/api/v1/omnimessages`

Send fallback of messages via platform

## Authentication

- `BasicAuth` — http basic AND `X-Api-Key` — apiKey in header: `X-Api-Key`

## Request body

- Content type: `application/json`
  - request body (object)
    - `contact` (string)
    - `cooldown` (integer)
    - `isOtp` (boolean)
    - `messages` (array)
      - `items` (object)
        - `channel`
          - (allOf)
            - value: … (nested further)
        - `clientInfo` (string)
        - `contact` (string)
        - `payload` (object)
        - `senderId` (string)
        - `successOn` (string, one of: sent, delivered, seen, default: "sent")
        - `template` (object)
        - `timeout` (integer, default: 1200)
        - `ttl` (integer)
    - `webhook` (string)

## Response 202

Accepted
  - response (object)
    - `data` (object)
      - `messages` (array)
        - `items` (object)
          - `channel`
            - (allOf)
              - value: … (nested further)
          - `messageId` (string)
          - `transactionId` (string)
      - `omniTransactionId` (string)
      - `timestamp` (string)
    - `error` (boolean)

## Response 400

Bad Request
  - response (object)
    - `data` (object)
      - `message` (string)
      - `requestId` (string)
    - `error` (boolean)

## Response 401

Unauthorized
  - response (object)
    - `data` (object)
      - `message` (string)
      - `requestId` (string)
    - `error` (boolean)

## Response 404

Not Found
  - response (object)
    - `data` (object)
      - `message` (string)
      - `requestId` (string)
    - `error` (boolean)

## Response 500

Internal Server Error
  - response (object)
    - `data` (object)
      - `message` (string)
      - `requestId` (string)
    - `error` (boolean)


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://iba-platform.jamdesk.app/api-specs.zip