Skip to content


The method is aimed for receiving one incoming notification from the notifications queue.

ReceiveNotification method waits for a notification receipt for 5 sec. The method call ends with an empty response if a timeout is reached. If a notification comes to the queue within 5 seconds, the method call is completed, and the method returns the received notification.

After receiving and processing an incoming notification, you need to delete the notification from the queue. This requires you to run DeleteNotification method. After calling DeleteNotification method, the notification will be considered received and processed and will be permanently deleted from the queue. Therefore, the next call of ReceiveNotification method will return the next notification from the queue in the order in which notifications come to the queue.

Incoming notifications are stored in the queue for 24 hours.

Notifications are sent from the queue in FIFO order


To get the next incoming notification from the queue, you have to execute a request at:


For idInstance and apiTokenInstance request parameters, refer to Before you start section.


Response parameters#

Parameter Type Description
receiptId integer Receipt Id for deleting an incoming notification by DeleteNotification method
body object Incoming notification in accordance with Incoming notifications format

Response body example#

    "receiptId": 1234567,
    "body": {
        "typeWebhook": "incomingMessageReceived",
        "instanceData": {
            "idInstance": 1234,
            "wid": "",
            "typeInstance": "whatsapp"
        "timestamp": 1588091580,
        "idMessage": "F7AEC1B7086ECDC7E6E45923F5EDB825",
        "senderData": {
            "chatId": "",
            "sender": "",
            "senderName": "Green API"
                "textMessage":"I use Green-API to send this message to you!"

ReceiveNotification errors#

For a list of errors common to all methods, refer to Common errors section

HTTP code Error Id Description
400 Parameter idInstance not an integer idInstance parameter is not specified or contains non-digit characters
400 Parameter apiTokenInstance not define apiTokenInstance is not specified

Python request example#

import requests

url = "{{idInstance}}/receiveNotification/{{apiTokenInstance}}"

payload = {}
headers= {}

response = requests.request("GET", url, headers=headers, data = payload)


You can see the example of notifications receipt code on NodeJS in the file ReceiveNotifications