# HttpIntegrationProps

The integration properties.

Used as props by: [HttpIntegration](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.HttpIntegration.html)

- Source: [`aws-apigatewayv2/lib/http/integration.ts`](https://github.com/aws/aws-cdk/blob/v2.278.0/packages/aws-cdk-lib/aws-apigatewayv2/lib/http/integration.ts#L165)
- Type last changed: v2.235.0 · 15 Jan 2026

## Example

TypeScript:

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as cdk from 'aws-cdk-lib';
import { aws_apigatewayv2 as apigatewayv2 } from 'aws-cdk-lib';

declare const httpApiRef: apigatewayv2.IHttpApiRef;
declare const integrationCredentials: apigatewayv2.IntegrationCredentials;
declare const parameterMapping: apigatewayv2.ParameterMapping;
declare const payloadFormatVersion: apigatewayv2.PayloadFormatVersion;
const httpIntegrationProps: apigatewayv2.HttpIntegrationProps = {
  httpApi: httpApiRef,
  integrationType: apigatewayv2.HttpIntegrationType.HTTP_PROXY,

  // the properties below are optional
  connectionId: 'connectionId',
  connectionType: apigatewayv2.HttpConnectionType.VPC_LINK,
  credentials: integrationCredentials,
  integrationSubtype: apigatewayv2.HttpIntegrationSubtype.EVENTBRIDGE_PUT_EVENTS,
  integrationUri: 'integrationUri',
  method: apigatewayv2.HttpMethod.ANY,
  parameterMapping: parameterMapping,
  payloadFormatVersion: payloadFormatVersion,
  secureServerName: 'secureServerName',
  timeout: cdk.Duration.minutes(30),
};
```

Python:

```python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk as cdk
from aws_cdk import aws_apigatewayv2 as apigatewayv2

# http_api_ref: apigatewayv2.IHttpApiRef
# integration_credentials: apigatewayv2.IntegrationCredentials
# parameter_mapping: apigatewayv2.ParameterMapping
# payload_format_version: apigatewayv2.PayloadFormatVersion

http_integration_props = apigatewayv2.HttpIntegrationProps(
    http_api=http_api_ref,
    integration_type=apigatewayv2.HttpIntegrationType.HTTP_PROXY,

    # the properties below are optional
    connection_id="connectionId",
    connection_type=apigatewayv2.HttpConnectionType.VPC_LINK,
    credentials=integration_credentials,
    integration_subtype=apigatewayv2.HttpIntegrationSubtype.EVENTBRIDGE_PUT_EVENTS,
    integration_uri="integrationUri",
    method=apigatewayv2.HttpMethod.ANY,
    parameter_mapping=parameter_mapping,
    payload_format_version=payload_format_version,
    secure_server_name="secureServerName",
    timeout=cdk.Duration.minutes(30)
)
```

Java:

```java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.*;
import software.amazon.awscdk.services.apigatewayv2.*;

IHttpApiRef httpApiRef;
IntegrationCredentials integrationCredentials;
ParameterMapping parameterMapping;
PayloadFormatVersion payloadFormatVersion;

HttpIntegrationProps httpIntegrationProps = HttpIntegrationProps.builder()
        .httpApi(httpApiRef)
        .integrationType(HttpIntegrationType.HTTP_PROXY)

        // the properties below are optional
        .connectionId("connectionId")
        .connectionType(HttpConnectionType.VPC_LINK)
        .credentials(integrationCredentials)
        .integrationSubtype(HttpIntegrationSubtype.EVENTBRIDGE_PUT_EVENTS)
        .integrationUri("integrationUri")
        .method(HttpMethod.ANY)
        .parameterMapping(parameterMapping)
        .payloadFormatVersion(payloadFormatVersion)
        .secureServerName("secureServerName")
        .timeout(Duration.minutes(30))
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK;
using Amazon.CDK.AWS.Apigatewayv2;

IHttpApiRef httpApiRef;
IntegrationCredentials integrationCredentials;
ParameterMapping parameterMapping;
PayloadFormatVersion payloadFormatVersion;

var httpIntegrationProps = new HttpIntegrationProps {
    HttpApi = httpApiRef,
    IntegrationType = HttpIntegrationType.HTTP_PROXY,

    // the properties below are optional
    ConnectionId = "connectionId",
    ConnectionType = HttpConnectionType.VPC_LINK,
    Credentials = integrationCredentials,
    IntegrationSubtype = HttpIntegrationSubtype.EVENTBRIDGE_PUT_EVENTS,
    IntegrationUri = "integrationUri",
    Method = HttpMethod.ANY,
    ParameterMapping = parameterMapping,
    PayloadFormatVersion = payloadFormatVersion,
    SecureServerName = "secureServerName",
    Timeout = Duration.Minutes(30)
};
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import cdk "github.com/aws/aws-cdk-go/awscdk"
import "github.com/aws/aws-cdk-go/awscdk"

var httpApiRef IHttpApiRef
var integrationCredentials IntegrationCredentials
var parameterMapping ParameterMapping
var payloadFormatVersion PayloadFormatVersion

httpIntegrationProps := &HttpIntegrationProps{
	HttpApi: httpApiRef,
	IntegrationType: awscdk.Aws_apigatewayv2.HttpIntegrationType_HTTP_PROXY,

	// the properties below are optional
	ConnectionId: jsii.String("connectionId"),
	ConnectionType: awscdk.*Aws_apigatewayv2.HttpConnectionType_VPC_LINK,
	Credentials: integrationCredentials,
	IntegrationSubtype: awscdk.*Aws_apigatewayv2.HttpIntegrationSubtype_EVENTBRIDGE_PUT_EVENTS,
	IntegrationUri: jsii.String("integrationUri"),
	Method: awscdk.*Aws_apigatewayv2.HttpMethod_ANY,
	ParameterMapping: parameterMapping,
	PayloadFormatVersion: payloadFormatVersion,
	SecureServerName: jsii.String("secureServerName"),
	Timeout: cdk.Duration_Minutes(jsii.Number(30)),
}
```

## Properties

- `connectionId`: string = undefined — The ID of the VPC link for a private integration.

  Supported only for HTTP APIs.

- `connectionType`: [HttpConnectionType](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.HttpConnectionType.html) = HttpConnectionType.INTERNET — The type of the network connection to the integration endpoint.

- `credentials`: [IntegrationCredentials](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.IntegrationCredentials.html) — The credentials with which to invoke the integration.

  **Default:** no credentials, use resource-based permissions on supported AWS services

- `httpApi`: [IHttpApiRef](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.IHttpApiRef.html) (required) — The HTTP API to which this integration should be bound.

- `integrationSubtype`: [HttpIntegrationSubtype](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.HttpIntegrationSubtype.html) — Integration subtype.

  **Default:** none, required if no `integrationUri` is defined.

  Used for AWS Service integrations, specifies the target of the integration.

- `integrationType`: [HttpIntegrationType](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.HttpIntegrationType.html) (required) — Integration type.

- `integrationUri`: string — Integration URI.

  **Default:** none, required if no `integrationSubtype` is defined.

  This will be the function ARN in the case of `HttpIntegrationType.AWS_PROXY`,
  or HTTP URL in the case of `HttpIntegrationType.HTTP_PROXY`.

- `method`: [HttpMethod](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.HttpMethod.html) — The HTTP method to use when calling the underlying HTTP proxy.

  **Default:** none. required if the integration type is `HttpIntegrationType.HTTP_PROXY`.

- `parameterMapping`: [ParameterMapping](https://docs.aws.amazon.com/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](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2.PayloadFormatVersion.html) — The version of the payload format.

  **Default:** defaults to latest in the case of HttpIntegrationType.AWS_PROXY`, irrelevant otherwise.

- `secureServerName`: string — Specifies the TLS configuration for a private integration.

  **Default:** undefined private integration traffic will use HTTP protocol

- `timeout`: [Duration](https://docs.aws.amazon.com/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.
