Amazon SQS

Send, receive and delete messages in Amazon SQS queues, create and configure standard and FIFO queues, and redrive dead-letter queues.

Actions

Action	What it does
Cancel dead-letter redrive	Stop a running redrive.
Change message visibility	Give a received message more (or less) time before it reappears for other receivers.
Create queue	Create a standard or FIFO queue.
Delete message	Remove a received message from the queue, so it is not delivered again.
Delete messages (batch)	Remove up to 10 received messages in one call - pass the 'receipt_handles' of a Receive messages step.
Delete queue	Delete a queue and every message in it.
Get queue details	Read a queue's settings, ARN and approximate message counts (the counts can lag by about a minute).
Get queue URL	Look up a queue's URL and ARN from its name.
List dead-letter redrives	The most recent redrive tasks for a dead-letter queue, newest first, with their progress.
List dead-letter source queues	List the queues that send their failed messages to this dead-letter queue.
List queue tags	Read a queue's cost-allocation tags.
List queues	List the queues in the connected region, optionally only those whose name starts with a prefix.
Purge queue	Delete every message in a queue, including ones currently being processed.
Receive messages	Receive up to 10 messages.
Remove queue tags	Remove tags from a queue by key.
Send message	Send one message to a queue (up to 1 MiB).
Send messages (batch)	Send up to 10 messages in one call.
Start dead-letter redrive	Move the messages in a dead-letter queue back to the queues they came from, or to another queue (a "DLQ redrive").
Tag queue	Add tags to a queue.
Update queue settings	Change a queue's settings.

Cancel dead-letter redrive

Stop a running redrive. Messages already moved stay where they are; only a RUNNING task can be cancelled.

Inputs

Task handletask_handletextRequired: The task_handle from Start dead-letter redrive, or running_task_handle from List dead-letter redrives.

Outputs

resultobject

Example output

{
  "result": {
    "approximate_number_of_messages_moved": 4,
    "cancelled": true,
    "task_handle": "eyJ0YXNrSWQiOiJkYzE2OWUwNC0wZTU1LTQ0ZDItYWE5MC1jMDgwY2ExZjM2ZjciLCJzb3VyY2VBcm4iOiJhcm46YXdzOnNxczp1cy1lYXN0LTE6MTIzNDU2Nzg5MDEyOm9yZGVycy1kbHEifQ=="
  }
}

Change message visibility

Give a received message more (or less) time before it reappears for other receivers. Set 0 to release it immediately. The clock restarts from now.

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.
Receipt handlereceipt_handletextRequired: The receipt_handle from the Receive messages step (not the message id). It is only valid until the message's visibility timeout ends.
Visibility timeout (seconds)visibility_timeoutnumberRequired: Seconds from now until the message reappears, 0-43200.From 0 to 43200.

Outputs

resultobject

Example output

{
  "result": {
    "changed": true,
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders",
    "visibility_timeout": 120
  }
}

Create a standard or FIFO queue. If a queue with this name already exists with exactly these settings, it is returned instead; with different settings the step fails. A new queue can take a second before it accepts messages.

Inputs

Queue namequeue_nametextRequired: Up to 80 letters, digits, '-' and '_'. For a FIFO queue '.fifo' is added if you leave it off.
FIFO queuefifo_queuetrue/false: Keep messages in order and deliver each exactly once. Cannot be changed after the queue is created.Default: false.
Visibility timeout (seconds)visibility_timeoutnumber: How long a received message stays hidden from other receivers before it reappears, 0-43200. New queues default to 30.From 0 to 43200.
Delivery delay (seconds)delay_secondsnumber: How long every new message waits before it can be received, 0-900. New queues default to 0.From 0 to 900.
Message retention (seconds)message_retention_periodnumber: How long SQS keeps an undeleted message, 60 (1 minute) to 1209600 (14 days). New queues default to 345600 (4 days).From 60 to 1209600.
Maximum message size (bytes)maximum_message_sizenumber: The largest message the queue accepts, 1024-1048576. New queues default to 1048576 (1 MiB).From 1024 to 1048576.
Receive wait time (seconds)receive_message_wait_time_secondsnumber: Default long-poll wait for Receive messages, 0-20. Above 0 reduces empty receives. New queues default to 0.From 0 to 20.
Content-based deduplicationcontent_based_deduplicationtrue/false: FIFO queues only: treat messages with the same body as duplicates, so a deduplication id is not needed on send.
Dead-letter queuedead_letter_queuetext: A queue to move messages to after they have been received 'Max receive count' times without being deleted. It must be the same type (standard or FIFO) and in the same region.
Max receive countmax_receive_countnumber: With a dead-letter queue: receives before a message moves there, 1-1000. Default 10.From 1 to 1000.
Tagstagsobject: Cost-allocation tags as key: value pairs.

Outputs

resultobject

Example output

{
  "result": {
    "fifo_queue": false,
    "queue_arn": "arn:aws:sqs:us-east-1:123456789012:orders",
    "queue_name": "orders",
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders"
  }
}

Delete message

Remove a received message from the queue, so it is not delivered again. Use the receipt handle, not the message id.

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.
Receipt handlereceipt_handletextRequired: The receipt_handle from the Receive messages step (not the message id). It is only valid until the message's visibility timeout ends.

Outputs

resultobject

Example output

{
  "result": {
    "deleted": true,
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders"
  }
}

Delete messages (batch)

Remove up to 10 received messages in one call - pass the 'receipt_handles' of a Receive messages step. Fails only when none could be deleted.

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.
Receipt handlesreceipt_handleslistRequired: 1-10 receipt handles from Receive messages.

Outputs

resultobject

Example output

{
  "result": {
    "deleted_receipt_handles": [
      "AQEBzWwaftRI0KuVm4tP+/7q1rGgNqicHq..."
    ],
    "failed": [],
    "failed_count": 0,
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders",
    "successful_count": 1
  }
}

Delete queue

Delete a queue and every message in it. There is no undo, and the name cannot be reused for 60 seconds.

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.

Outputs

resultobject

Example output

{
  "result": {
    "deleted": true,
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders"
  }
}

Get queue details

Read a queue's settings, ARN and approximate message counts (the counts can lag by about a minute).

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.
Attributesattribute_nameslist: Which attributes to read. Leave empty for all.One or more of: Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, and 11 more.

Outputs

resultobject

Example output

{
  "result": {
    "attributes": {
      "ApproximateNumberOfMessages": "3",
      "QueueArn": "arn:aws:sqs:us-east-1:123456789012:orders",
      "VisibilityTimeout": "30"
    },
    "queue": {
      "approximate_number_of_messages": 3,
      "approximate_number_of_messages_delayed": 0,
      "approximate_number_of_messages_not_visible": 0,
      "content_based_deduplication": null,
      "created_at": "2026-09-22T08:00:00Z",
      "dead_letter_target_arn": "arn:aws:sqs:us-east-1:123456789012:orders-dlq",
      "deduplication_scope": null,
      "delay_seconds": 0,
      "fifo_queue": null,
      "fifo_throughput_limit": null,
      "kms_data_key_reuse_period_seconds": null,
      "kms_master_key_id": null,
      "last_modified_at": "2026-09-22T08:00:00Z",
      "max_receive_count": 5,
      "maximum_message_size": 1048576,
      "message_retention_period": 345600,
      "policy": null,
      "queue_arn": "arn:aws:sqs:us-east-1:123456789012:orders",
      "receive_message_wait_time_seconds": 0,
      "redrive_allow_policy": null,
      "redrive_policy": {
        "deadLetterTargetArn": "arn:aws:sqs:us-east-1:123456789012:orders-dlq",
        "maxReceiveCount": 5
      },
      "sqs_managed_sse_enabled": true,
      "visibility_timeout": 30
    },
    "queue_name": "orders",
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders"
  }
}

Get queue URL

Look up a queue's URL and ARN from its name. Also works for another account's queue that you have been given access to.

Inputs

Queue namequeue_nametextRequired: The queue's exact name, for example 'orders' or 'orders.fifo'.
Owner account idqueue_owner_account_idtext: Only for a queue in another AWS account: that account's 12-digit id.

Outputs

resultobject

Example output

{
  "result": {
    "queue_arn": "arn:aws:sqs:us-east-1:123456789012:orders",
    "queue_name": "orders",
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders"
  }
}

List dead-letter redrives

The most recent redrive tasks for a dead-letter queue, newest first, with their progress.

Inputs

Dead-letter queuesource_queuetextRequired: The dead-letter queue the redrives moved messages from.
Max resultsmax_resultsnumber: How many tasks, 1-10. Default 1 (the latest).From 1 to 10.

Outputs

resultobject

Example output

{
  "result": {
    "count": 1,
    "running_task_handle": "eyJ0YXNrSWQiOiJkYzE2OWUwNC0wZTU1LTQ0ZDItYWE5MC1jMDgwY2ExZjM2ZjciLCJzb3VyY2VBcm4iOiJhcm46YXdzOnNxczp1cy1lYXN0LTE6MTIzNDU2Nzg5MDEyOm9yZGVycy1kbHEifQ==",
    "source_arn": "arn:aws:sqs:us-east-1:123456789012:orders-dlq",
    "tasks": [
      {
        "approximate_number_of_messages_moved": 4,
        "approximate_number_of_messages_to_move": 10,
        "destination_arn": null,
        "failure_reason": null,
        "max_number_of_messages_per_second": 1,
        "source_arn": "arn:aws:sqs:us-east-1:123456789012:orders-dlq",
        "started_at": "2026-09-22T08:05:00Z",
        "status": "RUNNING",
        "task_handle": "eyJ0YXNrSWQiOiJkYzE2OWUwNC0wZTU1LTQ0ZDItYWE5MC1jMDgwY2ExZjM2ZjciLCJzb3VyY2VBcm4iOiJhcm46YXdzOnNxczp1cy1lYXN0LTE6MTIzNDU2Nzg5MDEyOm9yZGVycy1kbHEifQ=="
      }
    ]
  }
}

List dead-letter source queues

List the queues that send their failed messages to this dead-letter queue.

Inputs

QueuequeuetextRequired: The dead-letter queue. Pick it, or enter its URL, ARN or name.
Max resultsmax_resultsnumber: How many queues per page, 1-1000. Default 1000.From 1 to 1000.
Next tokennext_tokentext: The 'next_token' from a previous page, to read the next one.

Outputs

resultobject

Example output

{
  "result": {
    "count": 1,
    "has_more": false,
    "next_token": null,
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders-dlq",
    "queues": [
      {
        "queue_name": "orders",
        "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders"
      }
    ]
  }
}

List queue tags

Read a queue's cost-allocation tags.

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.

Outputs

resultobject

Example output

{
  "result": {
    "count": 1,
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders",
    "tags": {
      "team": "payments"
    }
  }
}

List queues

List the queues in the connected region, optionally only those whose name starts with a prefix.

Inputs

Name prefixqueue_name_prefixtext: Only queues whose name starts with this (case-sensitive).
Max resultsmax_resultsnumber: How many queues per page, 1-1000. Default 1000.From 1 to 1000.
Next tokennext_tokentext: The 'next_token' from a previous page, to read the next one.

Outputs

resultobject

Example output

{
  "result": {
    "count": 1,
    "has_more": false,
    "next_token": null,
    "queue_urls": [
      "https://sqs.us-east-1.amazonaws.com/123456789012/orders"
    ],
    "queues": [
      {
        "queue_name": "orders",
        "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders"
      }
    ]
  }
}

Purge queue

Delete every message in a queue, including ones currently being processed. The queue itself stays. There is no undo, and a queue can be purged at most once a minute.

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.

Outputs

resultobject

Example output

{
  "result": {
    "purged": true,
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders"
  }
}

Receive messages

Receive up to 10 messages. Receiving does not remove them: each stays hidden for the visibility timeout and then reappears, so follow this with Delete message once it is handled. With no wait time SQS may return fewer messages than the queue holds, or none - set a wait time to long-poll.

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.
Max messagesmax_number_of_messagesnumber: How many to receive at most, 1-10. Default 1.From 1 to 10.
Wait time (seconds)wait_time_secondsnumber: Wait up to this long for a message to arrive, 0-20. Leave empty to use the queue's own setting.From 0 to 20.
Visibility timeout (seconds)visibility_timeoutnumber: How long these messages stay hidden, 0-43200. Leave empty to use the queue's own setting.From 0 to 43200.
Message attributes to returnmessage_attribute_nameslist: Names of message attributes to include; a name ending in '.*' matches a prefix. Leave empty for all.
System attributes to returnmessage_system_attribute_nameslist: Which SQS system attributes to include. Leave empty for all.One or more of: SenderId, SentTimestamp, ApproximateReceiveCount, ApproximateFirstReceiveTimestamp, SequenceNumber, MessageDeduplicationId, MessageGroupId, AWSTraceHeader, DeadLetterQueueSourceArn.
Receive attempt idreceive_request_attempt_idtext: FIFO queues only: reuse the same id to retry a receive that timed out and get the same messages back.

Outputs

resultobject

Example output

{
  "result": {
    "count": 1,
    "messages": [
      {
        "attributes": {
          "ApproximateFirstReceiveTimestamp": "1790064065456",
          "ApproximateReceiveCount": "1",
          "SenderId": "AIDASSYFHUBOBT7F4XT75",
          "SentTimestamp": "1790064062123"
        },
        "body": "{\"order_id\": 1042, \"status\": \"paid\"}",
        "body_json": {
          "order_id": 1042,
          "status": "paid"
        },
        "dead_letter_queue_source_arn": null,
        "first_received_at": "2026-09-22T08:01:05.456000Z",
        "md5_of_body": "fafb00f5732ab283681e124bf8747ed1",
        "message_attributes": {
          "source": "checkout"
        },
        "message_deduplication_id": null,
        "message_group_id": null,
        "message_id": "5fea7756-0ea4-451a-a703-a558b933e274",
        "receipt_handle": "AQEBzWwaftRI0KuVm4tP+/7q1rGgNqicHq...",
        "receive_count": 1,
        "sender_id": "AIDASSYFHUBOBT7F4XT75",
        "sent_at": "2026-09-22T08:01:02.123000Z",
        "sequence_number": null
      }
    ],
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders",
    "receipt_handles": [
      "AQEBzWwaftRI0KuVm4tP+/7q1rGgNqicHq..."
    ]
  }
}

Remove queue tags

Remove tags from a queue by key. A key the queue does not have is ignored.

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.
Tag keystag_keyslistRequired: The keys of the tags to remove.

Outputs

resultobject

Example output

{
  "result": {
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders",
    "removed_tag_keys": [
      "team"
    ],
    "untagged": true
  }
}

Send message

Send one message to a queue (up to 1 MiB).

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.
Messagemessage_bodytextRequired: The message text. Pick an object from an earlier step to send it as JSON.
Message attributesmessage_attributesobject: Up to 10 name: value pairs sent alongside the body, for consumers to filter on. Numbers are sent as SQS Number attributes.
Delay (seconds)delay_secondsnumber: Hide this message for this long after sending, 0-900. Standard queues only; FIFO queues use the queue's delay.From 0 to 900.
Message group idmessage_group_idtext: Required for a FIFO queue: messages with the same group id are delivered in order. Optional on a standard queue.
Deduplication idmessage_deduplication_idtext: FIFO queues only: a message with the same id sent within 5 minutes is dropped as a duplicate. Not needed when the queue has content-based deduplication.

Outputs

resultobject

Example output

{
  "result": {
    "md5_of_message_attributes": null,
    "md5_of_message_body": "fafb00f5732ab283681e124bf8747ed1",
    "message_id": "5fea7756-0ea4-451a-a703-a558b933e274",
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders",
    "sequence_number": null
  }
}

Send messages (batch)

Send up to 10 messages in one call. Each item is a message body (objects are sent as JSON). If some fail, the step still succeeds and lists them under 'failed'; it fails only when none were sent.

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.
MessagesmessageslistRequired: 1-10 messages. Text or objects; an object with a 'body' key may also set 'id', 'delay_seconds', 'message_group_id', 'message_deduplication_id' and 'message_attributes' for that message.
Message group idmessage_group_idtext: For a FIFO queue: the group for every message that does not set its own.

Outputs

resultobject

Example output

{
  "result": {
    "failed": [],
    "failed_count": 0,
    "message_ids": [
      "5fea7756-0ea4-451a-a703-a558b933e274"
    ],
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders",
    "successful": [
      {
        "id": "msg-1",
        "md5_of_message_body": "fafb00f5732ab283681e124bf8747ed1",
        "message_id": "5fea7756-0ea4-451a-a703-a558b933e274",
        "sequence_number": null
      }
    ],
    "successful_count": 1
  }
}

Start dead-letter redrive

Move the messages in a dead-letter queue back to the queues they came from, or to another queue (a "DLQ redrive"). Runs in the background; one per queue at a time.

Inputs

Dead-letter queuesource_queuetextRequired: The dead-letter queue to empty. Another queue's dead-letter setting must point at it.
Destination queuedestination_queuetext: Where to move the messages. Leave empty to send each back to the queue it originally came from.
Max messages per secondmax_number_of_messages_per_secondnumber: Rate limit for the move, 1-500. Leave empty to let SQS choose.From 1 to 500.

Outputs

resultobject

Example output

{
  "result": {
    "destination_arn": null,
    "source_arn": "arn:aws:sqs:us-east-1:123456789012:orders-dlq",
    "task_handle": "eyJ0YXNrSWQiOiJkYzE2OWUwNC0wZTU1LTQ0ZDItYWE5MC1jMDgwY2ExZjM2ZjciLCJzb3VyY2VBcm4iOiJhcm46YXdzOnNxczp1cy1lYXN0LTE6MTIzNDU2Nzg5MDEyOm9yZGVycy1kbHEifQ=="
  }
}

Tag queue

Add tags to a queue. A key that already exists gets the new value; other tags are left alone.

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.
TagstagsobjectRequired: Tags as key: value pairs (at most 50 per queue).

Outputs

resultobject

Example output

{
  "result": {
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders",
    "tagged": true,
    "tags": {
      "team": "payments"
    }
  }
}

Update queue settings

Change a queue's settings. Only the fields you fill in are changed. Changes can take up to a minute to apply (message retention up to 15 minutes).

Inputs

QueuequeuetextRequired: Pick a queue, or enter its URL, ARN or name. It must be in the region you connected with.
Visibility timeout (seconds)visibility_timeoutnumber: How long a received message stays hidden from other receivers before it reappears, 0-43200. New queues default to 30.From 0 to 43200.
Delivery delay (seconds)delay_secondsnumber: How long every new message waits before it can be received, 0-900. New queues default to 0.From 0 to 900.
Message retention (seconds)message_retention_periodnumber: How long SQS keeps an undeleted message, 60 (1 minute) to 1209600 (14 days). New queues default to 345600 (4 days).From 60 to 1209600.
Maximum message size (bytes)maximum_message_sizenumber: The largest message the queue accepts, 1024-1048576. New queues default to 1048576 (1 MiB).From 1024 to 1048576.
Receive wait time (seconds)receive_message_wait_time_secondsnumber: Default long-poll wait for Receive messages, 0-20. Above 0 reduces empty receives. New queues default to 0.From 0 to 20.
Content-based deduplicationcontent_based_deduplicationtrue/false: FIFO queues only: treat messages with the same body as duplicates, so a deduplication id is not needed on send.
Dead-letter queuedead_letter_queuetext: A queue to move messages to after they have been received 'Max receive count' times without being deleted. It must be the same type (standard or FIFO) and in the same region.
Max receive countmax_receive_countnumber: With a dead-letter queue: receives before a message moves there, 1-1000. Default 10.From 1 to 1000.

Outputs

resultobject

Example output

{
  "result": {
    "attributes": {
      "VisibilityTimeout": "60"
    },
    "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789012/orders",
    "updated": true,
    "updated_attributes": [
      "VisibilityTimeout"
    ]
  }
}

ActionsCopy Anchor Link

Cancel dead-letter redriveCopy Anchor Link

Inputs

Outputs

Change message visibilityCopy Anchor Link

Inputs

Outputs

Create queueCopy Anchor Link

Inputs

Outputs

Delete messageCopy Anchor Link

Inputs

Outputs

Delete messages (batch)Copy Anchor Link

Inputs

Outputs

Delete queueCopy Anchor Link

Inputs

Outputs

Get queue detailsCopy Anchor Link

Inputs

Outputs

Get queue URLCopy Anchor Link

Inputs

Outputs

List dead-letter redrivesCopy Anchor Link

Inputs

Outputs

List dead-letter source queuesCopy Anchor Link

Inputs

Outputs

List queue tagsCopy Anchor Link

Inputs

Outputs

List queuesCopy Anchor Link

Inputs

Outputs

Purge queueCopy Anchor Link

Inputs

Outputs

Receive messagesCopy Anchor Link

Inputs

Outputs

Remove queue tagsCopy Anchor Link

Inputs

Outputs

Send messageCopy Anchor Link

Inputs

Outputs

Send messages (batch)Copy Anchor Link

Inputs

Outputs

Start dead-letter redriveCopy Anchor Link

Inputs

Outputs

Tag queueCopy Anchor Link

Inputs

Outputs

Update queue settingsCopy Anchor Link

Inputs

Outputs

On this page

Actions

Cancel dead-letter redrive

Change message visibility

Create queue

Delete message

Delete messages (batch)

Delete queue

Get queue details

Get queue URL

List dead-letter redrives

List dead-letter source queues

List queue tags

List queues

Purge queue

Receive messages

Remove queue tags

Send message

Send messages (batch)

Start dead-letter redrive

Tag queue

Update queue settings