# HttpLambdaIntegrationProps

Lambda Proxy integration properties.

Extends: HttpLambdaIntegrationProps
Used as props by: HttpLambdaIntegration

- Source: [`aws-apigatewayv2-integrations/lib/http/lambda.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-apigatewayv2-integrations/lib/http/lambda.ts#L20)
- Type last changed: v2.224.0 · 13 Nov 2025

## Example

```ts
import { HttpLambdaIntegration } from 'aws-cdk-lib/aws-apigatewayv2-integrations';

declare const booksDefaultFn: lambda.Function;

const httpApi = new apigwv2.HttpApi(this, 'HttpApi');

const getBooksIntegration = new HttpLambdaIntegration('GetBooksIntegration', booksDefaultFn, {
  scopePermissionToRoute: false,
});
const createBookIntegration = new HttpLambdaIntegration('CreateBookIntegration', booksDefaultFn, {
  scopePermissionToRoute: false,
});

httpApi.addRoutes({
  path: '/books',
  methods: [ apigwv2.HttpMethod.GET ],
  integration: getBooksIntegration,
});

httpApi.addRoutes({
  path: '/books',
  methods: [ apigwv2.HttpMethod.POST ],
  integration: createBookIntegration,
});
```

## Properties

- `parameterMapping`: [ParameterMapping](/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.ParameterMapping.html) — Specifies how to transform HTTP requests before sending them to the backend.

  **Default:** undefined requests are sent to the backend unmodified

- `payloadFormatVersion`: [PayloadFormatVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.PayloadFormatVersion.html) = PayloadFormatVersion.VERSION_2_0 — Version of the payload sent to the lambda handler.

- `scopePermissionToRoute`: boolean = true — Scope the permission for invoking the AWS Lambda down to the specific route associated with this integration.

  If this is set to `false`, the permission will allow invoking the AWS Lambda
  from any route. This is useful for reducing the AWS Lambda policy size
  for cases where the same AWS Lambda function is reused for many integrations.

- `timeout`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) = Duration.seconds(29) — The maximum amount of time an integration will run before it returns without a response.

  Must be between 50 milliseconds and 29 seconds.