Overview
This node sends messages to an Amazon Web Services (AWS) Simple Queue Service (SQS) queue. It is useful for integrating workflows with AWS SQS to enqueue messages for asynchronous processing, decoupling components, or buffering tasks.
Common scenarios include:
- Sending event notifications or logs to an SQS queue.
- Offloading time-consuming tasks by pushing messages to a queue for later processing.
- Integrating n8n workflows with other AWS services that consume from SQS.
For example, you can send JSON data received by the node directly as a message, or specify a custom message body. The node supports FIFO queues by allowing message group IDs and deduplication IDs, and lets you add message attributes and delay delivery.
Properties
| Name | Meaning |
|---|---|
| Queue | Select the target SQS queue URL to which the message will be sent. |
| Send Input Data | Whether to send the incoming node data as JSON in the message body (true), or use a custom message body (false). |
| Message Body | The content of the message to send when not sending input data. |
| Message Group ID | Message group ID for FIFO queues; required for FIFO queues to group messages. |
| Message Deduplication ID | Message deduplication ID for FIFO queues; optional if content-based deduplication is enabled. Defaults to current timestamp string. |
| Additional Options | Collection of extra options: |
| - Message Attributes | Key-value pairs of message attributes with name, data type (String, Number, Binary), and value. |
| - Delay Seconds | Number of seconds to delay message delivery (0 to 900). |
Output
The node outputs an array of JSON objects, one per input item, each containing:
MessageId: The unique ID assigned by AWS SQS to the sent message.MD5OfMessageBody: MD5 hash of the message body for integrity verification.SequenceNumber(optional): Present if the queue is FIFO, indicating the sequence number of the message.
If an error occurs and "Continue On Fail" is enabled, the output for that item contains an error field with the error message.
The node does not output binary data.
Dependencies
- Requires valid AWS credentials with permissions to send messages to SQS.
- AWS region must be specified in the credentials.
- The node uses the AWS SDK for JavaScript internally.
- The user must configure AWS credentials in n8n prior to using this node.
Troubleshooting
Common issues:
- Invalid or missing AWS credentials will cause authentication errors.
- Specifying a FIFO queue without providing a Message Group ID will result in errors.
- Message deduplication ID conflicts may cause messages to be ignored if content-based deduplication is disabled.
- Delay seconds outside the allowed range (0-900) will cause validation errors.
Error messages:
"AWS SQS Error: <message>"indicates an issue returned by AWS SQS service.- Errors related to loading queues indicate connectivity or permission problems.
Resolutions:
- Verify AWS credentials and permissions.
- Ensure correct queue URL and queue type (standard vs FIFO).
- Provide required parameters for FIFO queues.
- Check network connectivity to AWS endpoints.