Docs / Strand / connectors/aws-lambda

AWS Lambda

Direction: Read / Write | Type: aws.lambda

Amazon Lambda connector for invoking serverless functions. Supports synchronous (request/response) and asynchronous (fire-and-forget) invocations.

Required Permissions#

The IAM user or role must have the following permissions:

Operation Required IAM Permissions
invoke lambda:InvokeFunction
Tip: Scope permissions to specific function ARNs to follow the principle of least privilege.

Operations#

Operation Direction Description
invoke Write Invoke a Lambda function

Connector Configuration#

Field Required Default Description
Authentication Type No api_key Uses explicit credentials (the fields below).
Region Yes - AWS region code (e.g., us-east-1)
Endpoint URL No - Custom endpoint for a self-managed target or an AWS VPC endpoint. Leave empty for AWS.
Access Key ID Conditional - AWS access key (encrypted). Required when Authentication Type is api_key
Secret Access Key Conditional - AWS secret key (encrypted). Required when Authentication Type is api_key
Function Name No - Default Lambda function name or ARN (can be overridden at node level)

Node Configuration#

Field Required Description
Function Name No Lambda function name or ARN (overrides connector default)
Invocation Type No RequestResponse (synchronous, default) or Event (asynchronous)

Output#

Synchronous (RequestResponse)#

json

{
  "success": true,
  "status": "completed",
  "data": {
    "function_name": "my-function",
    "response": {"result": "value"}
  },
  "service": "aws.lambda",
  "operation": "invoke"
}

Access the Lambda response:

jinja2

{{ payload.data.response.result }}

Asynchronous (Event)#

json

{
  "success": true,
  "status": "invoked",
  "data": {
    "function_name": "my-function",
    "request_id": "abc-123"
  },
  "service": "aws.lambda",
  "operation": "invoke"
}

Example#

Connector Setup:

json

{
  "region": "us-east-1",
  "access_key_id": "AKIAIOSFODNN7EXAMPLE",
  "secret_access_key": "wJalrXUtnFEMI/K7MDENG...",
  "function_name": "process-order"
}

Node Configuration (sync):

Node Configuration (async):