---
title: "Send message"
description: "Send one message via platform"
openapi: "/openapi/omni-api.yaml POST /messages"
---

> **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/messages`

Send one message 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)
    - `channel`
      - (allOf)
        - value (integer, int32, one of: 0, 1, 2, 3, 4, 5, 6, 7, 8, 10, 11, 12, 13, 14)
    - `clientInfo` (string)
    - `contact` (string)
    - `isOtp` (boolean)
    - `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)
      - `channel`
        - (allOf)
          - value (integer, int32, one of: 0, 1, 2, 3, 4, 5, 6, 7, 8, 10, 11, 12, 13, 14)
      - `messageId` (string)
      - `transactionId` (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