---
title: "Get Message Steps"
slug: "get-message-steps"
tags: ["message queue", "message service"]
updated: 2023-01-04T16:18:54Z
published: 2023-01-04T16:18:54Z
canonical: "documentation.decisions.com/get-message-steps"
---

> ## 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** | Integration > Message Queues |

---

## Get Message

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.

#### Settings

| Property | Description | Data Type |
| --- | --- | --- |
| Queue Name | This setting is used to specify a queue to pull the message from. | String |
| Get Queue from Flow | If enabled, the message will be pulled from the connected queue in the Flow. This option requires the Flow to be created as a [message queue handler Flow](https://documentation.decisions.com/docs/setting-up-messaging-overview). | --- |

#### Outputs

| Property | Description | Data Type |
| --- | --- | --- |
| 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/image-1671480364532.png)

---

## Common Errors

### Missing Queue selection

If a [message queue](https://documentation.decisions.com/docs/about-messaging) 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)

## Related

- [Post Message](/post-message-steps.md)