---
title: "Get String Message"
slug: "get-string-message-common-message-queue-step"
updated: 2025-08-01T16:19:41Z
published: 2025-08-01T16:19:41Z
canonical: "documentation.decisions.com/get-string-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 String Message

| Step Details |
| --- |
| **Introduced in Version** | 4.0.0 |
| **Last Modified in Version** | 8.0.0 |
| **Location** | Integration > Message Queues |

The Get String Message step retrieves the string message from a specified queue either by the queue name or from the Flow itself. The step will retrieve a message from the defined queue under the SETTINGS category for the step.

### 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 | Name of queue to get string message from. | String |
| Get Queue from Flow | If enabled, the next available string 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 |

#### Output

| Property | Description | Data Type |
| --- | --- | --- |
| Done |  |  |
|  | Message Text | Contents of message as a single string. | String |

#### ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-07-31_11h13_59.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:

[Get Message from Message Queue](https://support.decisions.com/forum/topic309-get-message-from-message-queue.aspx)