Skip to content
ActionAWS SQSUpdated May 2026

How do I pull messages from an SQS queue?

Short answer: Drop the "AWS SQSReceive SQS Messages" action anywhere in your workflow, map the inputs from upstream nodes, and publish.

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

FieldTypeRequiredDescription
Queue URL
queue_url
stringRequiredA fully qualified URL (https://...) for the queue url.
Max Messages
max_messages
numberOptional1-10.
Wait Time (s)
wait_time_seconds
numberOptionalLong-poll timeout. 0-20.
Visibility Timeout (s)
visibility_timeout
numberOptionalHide from other consumers while you process. Delete before this expires.
Sample request
{
"queue_url": "e.g. https://example.com/path",
"max_messages": "{{trigger.max_messages}}",
"wait_time_seconds": "{{trigger.wait_time_seconds}}",
"visibility_timeout": "{{trigger.visibility_timeout}}"
}
Returns
{
"Messages": [
{
"Body": "{\"event\":\"order.created\"}",
"MD5OfBody": "...",
"MessageId": "abc",
"ReceiptHandle": "AQEBxyz..."
}
]
}

Use these fields in downstream nodes for routing, logging, or error handling.

Triggered by

Apps that pair well as the trigger for Receive SQS Messages.

Any of these apps can fire this action as part of a workflow.

FAQ

Questions about Receive SQS Messages.

What does the Receive SQS Messages action do in AWS SQS?
Long-polls the queue for up to 10 messages. Pass wait_time_seconds=20 for full long polling (waits up to 20s for new messages to arrive on quiet queues) — reduces empty-receive costs significantly. Schedule this on a cadence to drain a queue from a workflow.
What inputs does Receive SQS Messages require?
Required: Queue URL. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if AWS SQS returns an error?
The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.
Does Receive SQS Messages support batch operations?
Yes. Run Receive SQS Messages inside a Loop node to process arrays. Tiny Command handles AWS SQS's rate limits automatically so you don't have to throttle manually.
More actions

Other AWS SQS actions.

Send receive sqs messages from your workflows.

Triggered by anything in the catalog. Free tier available. No credit card.