# HttpEndpointProps

Props for defining an Http destination of a Kinesis Data Firehose delivery stream.

Extends: HttpEndpointProps
Extends: CommonDestinationProps
Used as props by: HttpEndpoint

- Source: [`aws-kinesisfirehose/lib/http-endpoint.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-kinesisfirehose/lib/http-endpoint.ts#L127)
- Type last changed: v2.265.0 · 13 Aug 2026

## Example

```ts
declare const endpointConfig: firehose.HttpEndpointConfig;
const httpDestination = new firehose.HttpEndpoint({
  endpointConfig,
});
```

## Properties

- `attributes`: [HttpAttribute](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesisfirehose.HttpAttribute.html)[] = None — Describes the metadata sent to the Http endpoint destination.

- `backupMode`: [HttpBackupMode](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesisfirehose.HttpBackupMode.html) — Describes the S3 bucket backup options for the data that Kinesis Data Firehose delivers to the Http endpoint destination.

  **Default:** Failed data only

- `bufferingHints`: [HttpBufferingHints](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesisfirehose.HttpBufferingHints.html) = None — The buffering options that can be used before data is delivered to the specified destination.

- `endpointConfig`: [HttpEndpointConfig](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesisfirehose.HttpEndpointConfig.html) (required) — Describes the configuration of the Http endpoint to which Kinesis Firehose delivers data.

- `loggingConfig`: [ILoggingConfig](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesisfirehose.ILoggingConfig.html) — Configuration that determines whether to log errors during data transformation or delivery failures, and specifies the CloudWatch log group for storing error logs.

  **Default:** errors will be logged and a log group will be created for you.

- `processor`: [IDataProcessor](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesisfirehose.IDataProcessor.html) — Use `processors` instead.

  **Default:** no data transformation will occur.

- `processors`: [IDataProcessor](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesisfirehose.IDataProcessor.html)[] — The data transformation that should be performed on the data before writing to the destination.

  **Default:** no data transformation will occur.

- `requestCompression`: [HttpCompression](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesisfirehose.HttpCompression.html) = None — Compress the body of a request before sending the request to the destination.

- `retryOptions`: [HttpRetryOptions](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesisfirehose.HttpRetryOptions.html) = None — The total amount of time that Kinesis Data Firehose spends on retries.

- `role`: [IRole](/cdk/api/v2/docs/aws-cdk-lib.aws_iam.IRole.html) — The IAM role associated with this destination.

  **Default:** a role will be created with default permissions.

  Assumed by Amazon Data Firehose to invoke processors and write to destinations

- `s3Backup`: [DestinationS3BackupProps](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesisfirehose.DestinationS3BackupProps.html) — The configuration for backing up source records to S3.

  **Default:** source records will not be backed up to S3.
