Kommo Delivery Status API
The Delivery Status API from Kommo — 1 operation(s) for delivery status.
The Delivery Status API from Kommo — 1 operation(s) for delivery status.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/kommo:kommo-delivery-status-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: chats-api Delivery Status API
version: '1.0'
servers:
- url: https://amojo.kommo.com/v2/origin/custom/
security:
- {}
tags:
- name: Delivery Status
paths:
/{scope_id}/{msgid}/delivery_status:
post:
summary: Update message delivery status
description: The method allows you to update the delivery status of a specific message.
operationId: update-delivery-status
parameters:
- name: scope_id
in: path
description: ID of the connected chat channel to the account. Can be obtained in the request for connecting a chat channel (https://developers.kommo.com/reference/connect-channel)
schema:
type: string
required: true
- name: msgid
in: path
description: Message ID in the Chats API
schema:
type: string
required: true
- name: Content-Type
in: header
description: Request data type. Currently, only application/json is supported.
schema:
type: string
enum:
- application/json
- name: Date
in: header
description: Date and time when the request was generated. The signature will be valid for 15 minutes from this Date. The date should be in the format “Thu, 01 Jan 2023 12:00:00 +0000” (RFC2822)
schema:
type: string
- name: Content-MD5
in: header
description: For the request body, it is necessary to calculate the MD5 hash and indicate it in the header in lowercase. At the same time, it is important to keep in mind that the request body is calculated as a stream of bytes without considering the end of JSON markup, and if there are “\n” or spaces at the end, they will also be taken into account. For GET requests, MD5 must also be calculated. Even if nothing is passed in the request body, MD5 will be obtained from an empty string.
schema:
type: string
- name: X-Signature
in: header
description: Signature of the request as a string. It is formed from the name of the method (GET/POST) in uppercase, with the values of the headers concatenated by “\n”. Header values come in a specific order. If there is no header, an empty string is specified instead. Next, add the requested path from the URL without the protocol and domain (without GET parameters) to the line. The resulting string is calculated using HMAC-SHA1, and as a secret, we use the channel secret obtained during registration. The resulting hash in lowercase is indicated in the X-Signature header.
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
RAW_BODY:
type: object
properties:
status_code:
type: integer
enum:
- 1
- 2
- -1
description: 'Message delivery status. Available statuses are described here: https://developers.kommo.com/reference/update-delivery-status#message-status-codes'
error_code:
type: integer
enum:
- 901
- 902
- 903
- 904
- 905
description: 'Error code. Required only if `"status_code": -1`. Available types are described here: https://developers.kommo.com/reference/update-delivery-status#error-codes'
error:
type: string
description: 'Error text that will be displayed in Kommo interface. Required only if `"status_code": -1` and `"error_code": 905`'
application/x-www-form-urlencoded:
schema:
type: object
properties:
RAW_BODY:
type: object
properties:
status_code:
type: integer
enum:
- '-'
- 1
- 2
- -1
error_code:
type: string
enum:
- '901'
- '902'
- '903'
- '904'
- '905'
error:
type: string
description: An error text will be displayed to the user. Don’t send in case of status not error.
multipart/form-data:
schema:
type: object
properties:
RAW_BODY:
type: object
properties:
msgid:
type: string
description: Message ID on Kommo side. You obtain it in the step 5. Must match the msgid in the method URL.
delivery_status:
type: string
enum:
- '-'
- '1'
- '2'
- '-1'
error_code:
type: string
enum:
- '901'
- '902'
- '903'
- '904'
- '905'
error:
type: string
description: An error text will be displayed to the user. Don’t send in case of status not error.
application/hal+json:
schema:
type: object
properties:
RAW_BODY:
type: object
properties:
msgid:
type: string
description: Message ID on Kommo side. You obtain it in the step 5. Must match the msgid in the method URL.
delivery_status:
type: string
enum:
- '-'
- '1'
- '2'
- '-1'
error_code:
type: string
enum:
- '901'
- '902'
- '903'
- '904'
- '905'
error:
type: string
description: An error text will be displayed to the user. Don’t send in case of status not error.
examples:
Request Example:
value:
msgid: XXXXXX-2aa3-464c-b6e4-4386d0f8f3ca
delivery_status: -1
error_code: 905
error: An unknown error occurred
responses:
'200':
description: '200'
content:
application/json:
examples:
Status updated successfully:
value: '{}'
schema:
type: object
properties: {}
'400':
description: '400'
content:
application/json:
examples:
Incorrect data was transmitted. Details are available in the response.:
value: '{}'
schema:
type: object
properties: {}
'403':
description: '403'
content:
text/plain:
examples:
Request signature is incorrect:
value: ''
'404':
description: '404'
content:
text/plain:
examples:
Message does not exist:
value: ''
deprecated: false
tags:
- Delivery Status
x-readme-fauxas: true
x-provenance:
method: searched
source: https://developers.kommo.com/reference
harvested: '2026-11-15'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://developers.kommo.com/reference/chat-history.md
- https://developers.kommo.com/reference/connect-channel.md
- https://developers.kommo.com/reference/create-chat.md
- https://developers.kommo.com/reference/disconnect-channel.md
- https://developers.kommo.com/reference/send-import-messages.md
- https://developers.kommo.com/reference/send-reactions.md
- https://developers.kommo.com/reference/typing-info.md
- https://developers.kommo.com/reference/update-delivery-status.md
- https://es-developers.kommo.com/reference/actualizar-el-estado-de-entrega-del-mensaje.md
- https://es-developers.kommo.com/reference/desconectar-el-canal-de-chat.md
- https://es-developers.kommo.com/reference/enviar-o-retirar-reacciones.md
- https://es-developers.kommo.com/reference/obtener-el-historial-del-chat.md
- https://es-developers.kommo.com/reference/paso-2-conectar-canal-de-chat.md
- https://es-developers.kommo.com/reference/paso-3-crear-nuevo-chat.md
- https://es-developers.kommo.com/reference/paso-5-enviar-recibir-o-importar-mensajes.md
- https://pt-developers.kommo.com/reference/atualizar-status-de-entrega-da-mensagem.md
- https://pt-developers.kommo.com/reference/conectar-canal-do-chat.md
- https://pt-developers.kommo.com/reference/criar-novo-chat.md
- https://pt-developers.kommo.com/reference/desconectar-canal-de-chat.md
- https://pt-developers.kommo.com/reference/enviar-receber-ou-importar-mensagens.md
- https://pt-developers.kommo.com/reference/obter-chats-de-contato.md
merge:
pages: 21
deduped: 0
conflicts_kept_first: 5