Academy
⌘K
Getting Started
  • Platform Overview
  • AWS Marketplace Setup
  • Quickstart Guide
Connections
  • Overview
Workflow Builder
  • Overview
  • Nodes Catalog
Helix AI Assistant
  • Overview
Mapping Engine
  • Overview
Workflow Library
  • Overview
  • HL7
  • FHIR
  • Insurance
  • Agentic
  • Mapping
Security & Infrastructure
  • Architecture
  • HIPAA Compliance
  • Performance & Scalability
← Back to ConnectHealth
Get Started
Back to Nodes
AWS1 input → 2 outputs

SQS Send

payload.queueUrl (string)payload.messag… (string|o…)payload.body (string|o…)payload.messag… (object)AWSSQS SendOutput 1payload.success (boolean)payload.Messag… (string)payload.sequen… (string)Output 2payload.success (boolean)payload.error (string)payload.errorT… (string)Data flowProperty

Sends a single message to an SQS queue (standard or FIFO).

Inputs

payload.queueUrl string
Overrides the Queue URL set in the node config.
payload.messageBody / payload.body string | object
The message to send. Objects are stringified automatically. If not set, falls back to the node's static Message Body, then to the entire msg.payload object.
payload.messageAttributes object
SQS MessageAttributeValue map, e.g. { Source: { DataType: 'String', StringValue: 'ehr-sync' } }.
payload.messageGroupId string
FIFO only — overrides the node config Message Group ID.
payload.messageDeduplicationId string
FIFO only — overrides the node config Message Dedup ID.

Outputs

Output 1 — Success
payload.success boolean
Always true.
payload.MessageId string
The AWS-assigned ID of the sent message.
payload.sequenceNumber string
FIFO queues only — the sequence number assigned by SQS.
sqs.operation string
"send"
sqs.queueUrl string
The queue that was sent to.
Output 2 — Error
payload.error string
Error message from AWS.
payload.errorType string
Human-readable error category (e.g. Queue Not Found, Auth Error).
payload.solution string
Suggested fix for the error.
payload.awsCode string
Raw AWS error code.

How to Use

  1. Select an AWS config node (or create one with your AWS credentials/region).
  2. Enter the Queue URL, or supply it at runtime via msg.payload.queueUrl.
  3. Optionally set a static Message Body, or send the payload as-is / via msg.payload.messageBody.
  4. For FIFO queues, set Message Group ID (required) and Message Dedup ID (unless content-based dedup is enabled on the queue).
  5. Wire the output: Output 1 = success (msg.payload.MessageId), Output 2 = AWS error.

ConnectHealth Example

Publish a FHIR sync event for downstream processing:

msg.payload = {
  queueUrl: "https://sqs.us-east-1.amazonaws.com/123456789012/fhir-sync.fifo",
  messageBody: { patientRef: "Patient/epic-A-123", eventType: "updated" },
  messageGroupId: "epic-hospital-A"
};

// Output 1 on success:
msg.payload = {
  success: true,
  MessageId: "d6b3f1d2-...-6b1a",
  sequenceNumber: "18849...002"
}

Best Practices

  • Never place PHI directly in Message Attributes — attributes are metadata and may be logged by consumers; keep PHI in the message body only.
  • For FIFO queues, choose a stable Message Group ID (e.g. per hospital/tenant) to preserve ordering within that group.
  • Use Output 2 to wire an error-handling branch (e.g. log the error and retry or alert).