n8n-nodes-aws-sdk-v3

This is an n8n community node that allows you to execute custom JavaScript code with pre-configured AWS SDK v3 clients (S3, Bedrock, SSM, Secrets Manager) in your n8n workflows.

Note: This node uses external dependencies (AWS SDK v3) and is only compatible with self-hosted n8n installations. It cannot be used on n8n Cloud.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

npm install n8n-nodes-aws-sdk-v3

Or install it directly in your n8n instance via the Community Nodes settings.

Operations

The AWS Code node provides a code editor where you can write custom JavaScript code with access to:

Pre-configured AWS Clients

• $s3 - Amazon S3 Client
• $bedrock - Amazon Bedrock Runtime Client
• $ssm - AWS Systems Manager (SSM) Client
• $secretsManager - AWS Secrets Manager Client

Available AWS SDK Commands

S3 Commands:

• ListBucketsCommand
• GetObjectCommand
• PutObjectCommand
• DeleteObjectCommand
• CopyObjectCommand
• HeadObjectCommand
• ListObjectsV2Command
• CreateBucketCommand
• DeleteBucketCommand

Bedrock Commands:

• InvokeModelCommand
• InvokeModelWithResponseStreamCommand
• ConverseCommand
• ConverseStreamCommand

SSM Commands:

• GetParameterCommand
• GetParametersCommand
• GetParametersByPathCommand
• PutParameterCommand
• DeleteParameterCommand
• DeleteParametersCommand

Secrets Manager Commands:

• GetSecretValueCommand
• BatchGetSecretValueCommand
• PutSecretValueCommand
• CreateSecretCommand
• UpdateSecretCommand
• DeleteSecretCommand
• DescribeSecretCommand
• ListSecretsCommand
• RestoreSecretCommand

Execution Modes

• Run Once for All Items - Execute the code once with access to all input items via $items
• Run Once for Each Item - Execute the code once for each input item via $item

Credentials

Create AWS SDK V3 API credentials with:

| Field | Description | |-------|-------------| | Access Key ID | Your AWS Access Key ID | | Secret Access Key | Your AWS Secret Access Key | | Region | AWS region (e.g., eu-west-1, us-east-1) | | Session Token | Optional - for temporary credentials (STS) |

Credential testing uses AWS STS GetCallerIdentity, so credentials can validate even without S3-specific permissions.

Compatibility

• Requires n8n version 1.0.0 or later
• Self-hosted n8n only - Not compatible with n8n Cloud

Usage

Example: List S3 Buckets

const response = await $s3.send(new ListBucketsCommand({}));
return response.Buckets.map(b => ({ json: { name: b.Name } }));

Example: Get SSM Parameter

const response = await $ssm.send(new GetParameterCommand({
  Name: '/my/parameter/path',
  WithDecryption: true
}));
return [{ json: { value: response.Parameter.Value } }];

Example: Invoke Bedrock Model (Claude)

const response = await $bedrock.send(new ConverseCommand({
  modelId: 'anthropic.claude-3-sonnet-20240229-v1:0',
  messages: [
    {
      role: 'user',
      content: [{ text: $item.json.prompt }]
    }
  ]
}));

return [{
  json: {
    response: response.output.message.content[0].text
  }
}];

Example: Get a Secret Value

const response = await $secretsManager.send(new GetSecretValueCommand({
  SecretId: 'my/app/secret',
}));

if (response.SecretString) {
  return [{ json: { secret: response.SecretString } }];
}

const secretBinaryBase64 = Buffer.from(response.SecretBinary).toString('base64');
return [{ json: { secretBinaryBase64 } }];

Example: Upload to S3

const response = await $s3.send(new PutObjectCommand({
  Bucket: 'my-bucket',
  Key: `files/${$item.json.filename}`,
  Body: $item.json.content,
  ContentType: 'text/plain'
}));

return [{ json: { success: true, etag: response.ETag } }];

Available Variables

| Variable | Description | |----------|-------------| | $s3 | Pre-configured S3Client | | $bedrock | Pre-configured BedrockRuntimeClient | | $ssm | Pre-configured SSMClient | | $secretsManager | Pre-configured SecretsManagerClient | | $items | All input items (array) | | $item | Current item (in "Run Once for Each Item" mode) | | $itemIndex | Current item index |

Resources

• n8n community nodes documentation
• AWS SDK for JavaScript v3 Documentation
• Amazon S3 Documentation
• Amazon Bedrock Documentation
• AWS Systems Manager Documentation
• AWS Secrets Manager Documentation

Version history

Unreleased

• Added AWS Secrets Manager client support ($secretsManager)
• Added key Secrets Manager commands to the runtime context
• Updated credentials test to use STS GetCallerIdentity

0.1.0

• Initial release
• AWS Code node with S3, Bedrock, and SSM support
• Custom credentials for AWS SDK v3