apigatewayv2-integrations: Add support for PutEvents to Eventbridge integration

[jolo-dev]

Describe the feature

ApiGatewayv2 HTTP API integrates with Eventbridge. It would be nice to have CDK implement this. See documentation on Eventbridge-PutEvent mapping.

Use Case

I want an easy way to use an Eventbridge Bus as a proxy for my HTTP API.

Proposed Solution

Similar to all the other integrations

    const stack = new Stack();
    const api = new HttpApi(stack, 'HttpApi');
    const bus = EventBus(stack, 'Events');
    new HttpRoute(stack, 'EventRoute', {
      httpApi: api,
      integration: new HttpEventBusIntegration('Integration', bus, {
        detail: ParameterMapping,
        detailType: string,
        source: string,
        invocationRole: Role,
        description?: string,
        time?: ParameterMapping,
        eventBusName?: bus.name,
        resources?: ParameterMapping,
        region?: string,
        traceHeader?: string,
        timeout?: number
      }),
      routeKey: HttpRouteKey.with('/pets'),
    });

Other Information

No response

Acknowledgements

• I may be able to implement this feature request
• This feature might incur a breaking change

AWS CDK Library version (aws-cdk-lib)

2.219.0

AWS CDK CLI version

2.1029.2 (build fccc5f9)

Environment details (OS name and version, etc.)

MacBook

[pahud]

Hi @jolo-dev,

Thank you for this feature request! This appears to be a valid enhancement to the @aws-cdk/aws-apigatewayv2-integrations package.

You're correct that while API Gateway v2 supports EventBridge PutEvents integration, the CDK currently lacks a high-level L2 construct to simplify this configuration. The good news is that the foundation is already in place - the HttpIntegrationSubtype.EVENTBRIDGE_PUT_EVENTS enum value exists, but we need to implement the L2 construct wrapper.

The implementation should follow the same pattern as the existing HttpSqsIntegration class, which:

• Automatically creates the IAM role with appropriate permissions
• Configures parameter mapping for EventBridge PutEvents API
• Provides a clean, typed API for developers

The implementation would need to:

1. Create a new eventbridge.ts file in the integrations package
2. Define HttpEventBridgeIntegrationProps interface with required parameters (Detail, DetailType, Source) and optional ones (EventBusName, Resources, Time)
3. Implement HttpEventBridgeIntegration class extending HttpRouteIntegration
4. Add appropriate unit tests and documentation

Since you've indicated you may be able to implement this feature request, we'd love to see a PR from you! If you need any guidance on the implementation details or have questions about the CDK contribution process, feel free to ask.

References:

• AWS EventBridge-PutEvents Integration Documentation
• EventBridge PutEvents API Reference

[jolo-dev]

Hey @pahud,
Cool, thanks for the write down and the trust 💯

Will try my best for the PR!