Tendrl

Docs / Contact / connectors/aws-sqs

AWS SQS

Provider: aws | Service: sqs | Direction: Write

Amazon Simple Queue Service connector for sending messages to an SQS queue.

Required Permissions

Operation Required IAM Permissions
Send message sqs:SendMessage
Tip: Scope permissions to the specific queue ARN to follow the principle of least privilege.

Operation

When a message reaches this connector, it sends a message to the configured queue. The payload must supply:

Payload field Required Description
message Yes Message body to send

Connector Configuration

The connector is created with type: "cloud", provider: "aws", service_type: "sqs", plus:

Field (config) Required Description
auth_type No api_key (default) or role for cross-account access. See below.
region No AWS region code. Derived automatically from queue_url if not set.
access_key Conditional AWS access key. Required when auth_type is api_key.
secret_key Conditional AWS secret key. Required when auth_type is api_key.
queue_url Yes SQS queue URL
Role-based (cross-account) authentication

Set auth_type: "role" to assume an IAM role in your AWS account via STS. Provide role_arn (required) and optionally external_id. With role auth you do not supply access_key/secret_key.

Output

json

{
  "status": "completed",
  "statusCode": 200,
  "data": {
    "status": "sent",
    "statusCode": 200,
    "method": "SQS_SEND_MESSAGE",
    "endpoint": "https://sqs.us-east-1.amazonaws.com/123456789/my-queue",
    "duration": 31,
    "response": { "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789/my-queue" }
  }
}

Example

Connector config (API key):

json

{
  "type": "cloud",
  "provider": "aws",
  "service_type": "sqs",
  "access_key": "${secrets.aws_access_key}",
  "secret_key": "${secrets.aws_secret_key}",
  "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789/my-queue"
}

Connector config (cross-account role):

json

{
  "type": "cloud",
  "provider": "aws",
  "service_type": "sqs",
  "auth_type": "role",
  "role_arn": "arn:aws:iam::123456789012:role/contact-sqs-writer",
  "queue_url": "https://sqs.us-east-1.amazonaws.com/123456789/my-queue"
}

← Back to Contact docs