---
title: "Message Queue Read Adaptor"
slug: "message-queue-read-adaptor"
updated: 2024-11-11T15:18:20Z
published: 2024-11-11T15:18:20Z
canonical: "help.csgi.com/message-queue-read-adaptor"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.csgi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Message Queue Read Adaptor

## Creating a Message Queue Read Adaptor

The **Message Queue Read Adaptor** reads the next available message from the message queue. If the message is in JSON format, then it will be parsed and mapped to the correct fields in the output record.

In order to use a **Message Queue Read Adaptor**, it is best practice to create a [message queue connection](/v1/docs/message-queue-connection) first.

![](https://cdn.document360.io/c578bb14-e570-4b6e-93ed-f6c5b8a2d8a1/Images/Documentation/new%20queue(2).png?sv=2026-02-06&spr=https&st=2026-10-26T14%3A16%3A31Z&se=2026-10-26T15%3A16%3A31Z&sr=c&sp=r&sig=HLii9rbs9UOXMIuy7OjTuUZvS83agVELTuZwi%2F%2BpII8%3D)

- To create a Message Queue Read, from the **Create New Item** page, select the **Queue** Adaptor from the right-hand side column.
- Give the queue adaptor a name, choose some tags, and click on the **Create Item** button.

![](https://cdn.document360.io/c578bb14-e570-4b6e-93ed-f6c5b8a2d8a1/Images/Documentation/2024-11-11_20-41-11(2).png?sv=2026-02-06&spr=https&st=2026-10-26T14%3A16%3A31Z&se=2026-10-26T15%3A16%3A31Z&sr=c&sp=r&sig=HLii9rbs9UOXMIuy7OjTuUZvS83agVELTuZwi%2F%2BpII8%3D)

- Choose the connection from the dropdown menu and then choose a destination location for the record.

![](https://cdn.document360.io/c578bb14-e570-4b6e-93ed-f6c5b8a2d8a1/Images/Documentation/new%20queue(3).png?sv=2026-02-06&spr=https&st=2026-10-26T14%3A16%3A31Z&se=2026-10-26T15%3A16%3A31Z&sr=c&sp=r&sig=HLii9rbs9UOXMIuy7OjTuUZvS83agVELTuZwi%2F%2BpII8%3D)

The Message Queue Read Adaptor will return an error if there is no message on the queue:

![](https://cdn.document360.io/c578bb14-e570-4b6e-93ed-f6c5b8a2d8a1/Images/Documentation/message%20queue%20error.png?sv=2026-02-06&spr=https&st=2026-10-26T14%3A16%3A31Z&se=2026-10-26T15%3A16%3A31Z&sr=c&sp=r&sig=HLii9rbs9UOXMIuy7OjTuUZvS83agVELTuZwi%2F%2BpII8%3D)

---

## Validation Warnings

![](https://cdn.document360.io/c578bb14-e570-4b6e-93ed-f6c5b8a2d8a1/Images/Documentation/Inavalis(4).png?sv=2026-02-06&spr=https&st=2026-10-26T14%3A16%3A31Z&se=2026-10-26T15%3A16%3A31Z&sr=c&sp=r&sig=HLii9rbs9UOXMIuy7OjTuUZvS83agVELTuZwi%2F%2BpII8%3D): All the invalid notifications will be displayed after expanding the **Invalid Dropdown**.

| Warning | Note |
| --- | --- |
| Adaptor(s) do not have connection set | It is necessary to create a connection and choose it from the Adaptor Connection dropdown |
| Node(s) have missing data destination/output | No data destination for the message read from the queue has been specified |

---

### See Also:

- [Message Queue Adaptor](/v1/docs/message-queue-adaptor)
- [Message Queue Write Adaptor](/v1/docs/message-queue-write-adaptor)
- [Message Queue Listener](/v1/docs/message-queue-listener)