---
title: "Get Message"
slug: "get-message-common-message-queue-step"
updated: 2025-08-01T16:19:34Z
published: 2025-08-01T16:19:34Z
canonical: "documentation.decisions.com/get-message-common-message-queue-step"
---

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

# Get Message

| Step Details |
| --- |
| **Introduced in Version** | 3.0.0 |
| **Last Modified in Version** | 8.0.0 |
| **Location** | Module > Messaging > About Messaging |

The Get Message step retrieves a message from a specified queue either by the queue name or from the flow itself. The step will retrieve a message added to the queue. The message will be returned as a MessageQueuemessage object, containing a list of attributes along with a list of Bytes representing the message payload.

### Prerequisites

This Step requires Users to install the [About Messaging](https://documentation.decisions.com/docs/about-messaging#message-queues-and-decisions) Module before it will be available in the toolbox.

In V9 a dependency must be established before the steps will be available in the toolbox.

---

## Properties

#### Settings

| Property | Description | Data Type |
| --- | --- | --- |
| Queue Name | This setting is used to specify the queue to pull a message from. | String |
| Get Queue from Flow | If enabled, the message will be pulled from a connected queue in the flow. This option requires the flow to be created as a message queue handler. | Boolean |

#### Outputs

| Property | Description | Data Type |
| --- | --- | --- |
| Done |  |  |
|  | Message | An object containing the message, along with additional metadata surrounding the message. | MessageQueueMessage |

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-01_12h10_48.png)

---

## Common Errors

#### Missing Queue Selection

If a message queue is not selected under the SETTINGS category for the step, the step will throw an error. Ensure that a queue has been selected before running the step.

Exception Message:

```cpp
Exception Stack Trace: DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Get String Message 1[GetStringMessage] in flow [Testing]: Object reference not set to an instance of an object. ---> System.NullReferenceException: Object reference not set to an instance of an object.   at DecisionsFramework.Data.Messaging.MessageServerEndpoint.GetQueueByName(String queueName)   at DecisionsFramework.Data.Messaging.MessagingService.GetQueueByName(String queueName)   at DecisionsFramework.Data.Messaging.BaseMessagingStep.GetQueue(StepStartData stepData)   at DecisionsFramework.Data.Messaging.GetStringMessage.Run(StepStartData data)   at DecisionsFramework.Design.Flow.FlowStep.RunStepInternal(String flowTrackingID, String stepTrackingID, KeyValuePairDataStructure[] stepRunDataValues, AbstractFlowTrackingData trackingData)   at DecisionsFramework.Design.Flow.FlowStep.Start(String flowTrackingID, String stepTrackingID, FlowStateData data, AbstractFlowTrackingData trackingData, RunningStepData currentStepData)
   --- End of inner exception stack trace ---
```

---

Related Information

Forum Posts:

- [Kafka Queue - Retrieving Multiple Messages](https://support.decisions.com/forum/topic2856-kafka-queue--retrieving-multiple-messages.aspx)