---
title: "Receive incoming message"
method: POST
path: "receive-instagram-api-incoming-messages"
tags: ["channels", "instagram", "incoming-instagram-message"]
---

# Receive incoming message

`POST receive-instagram-api-incoming-messages` (webhook)

Incoming messages will be forwarded to this endpoint. Please provide the endpoint’s URL to your Account Manager and they will set it up for you. Alternatively you can specify the endpoint per each message via the `webhooks > delivery > url` parameter. Contact support@infobip.com if you require help.

## Payload

- 8bb20f43a591755a249613f66cc72e7e0fcc9b313d81a59f9ca0e0ff261ac181InstagramDmInboundResponse
  - `results` 8bb20f43a591755a249613f66cc72e7e0fcc9b313d81a59f9ca0e0ff261ac181InboundMessageInstagramDmInboundContent[]: Collection of mobile originated messages.
    - `entityId` string: Used when specifying an entity in outbound send requests. It is also returned in notification events. For detailed usage, refer to the [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
    - `applicationId` string: Used when specifying an application in outbound send requests. It is also returned in notification events. For detailed usage, refer to the [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
    - `sender` string, required: Number which sent the message.
    - `to` string, required: Sender provided during the activation process.
    - `integrationType` string, required: Integration type.
    - `receivedAt` string, date-time, required: Date and time when Infobip received the message. Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ.
    - `keyword` string: Keyword extracted from the message text.
    - `messageId` string, required: The ID that uniquely identifies the received message.
    - `pairedMessageId` string: Message ID of paired outgoing message if matched by Infobip platform.
    - `callbackData` string: Callback data sent through ‛callbackData‛ field when sending message.
    - `message` 8bb20f43a591755a249613f66cc72e7e0fcc9b313d81a59f9ca0e0ff261ac181InstagramDmInboundContent, required: Message content.
      - `type` 'TEXT' | 'URL' | 'AUDIO' | 'VIDEO' | 'FILE' | 'IMAGE' | 'LOCATION' | 'LOCATION_URL' | 'POSTBACK' | 'SHARE' | 'STORY_MENTION' | 'PRODUCT' | 'IG_REEL' | 'IG_POST' | 'UNKNOWN'
    - `price` 8bb20f43a591755a249613f66cc72e7e0fcc9b313d81a59f9ca0e0ff261ac181MessagePrice, required: Sent message price.
      - `pricePerMessage` number: Price per one message.
      - `currency` string: The currency in which the price is expressed.
  - `messageCount` integer: The number of messages returned in the results array.
  - `pendingMessageCount` integer: The number of messages that have not been pulled in.

## Acknowledgement `200`

Your server returns this code if it accepts the callback.

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)