# CfnIntegrationProps

Properties for defining a `CfnIntegration`.

Extends: CfnIntegrationProps
Used as props by: CfnIntegration

- Source: Generated code
- Type last changed: v2.241.0 · 2 Mar 2026

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_customerprofiles as customerprofiles } from 'aws-cdk-lib';
const cfnIntegrationProps: customerprofiles.CfnIntegrationProps = {
  domainName: 'domainName',

  // the properties below are optional
  eventTriggerNames: ['eventTriggerNames'],
  flowDefinition: {
    flowName: 'flowName',
    kmsArn: 'kmsArn',
    sourceFlowConfig: {
      connectorType: 'connectorType',
      sourceConnectorProperties: {
        marketo: {
          object: 'object',
        },
        s3: {
          bucketName: 'bucketName',

          // the properties below are optional
          bucketPrefix: 'bucketPrefix',
        },
        salesforce: {
          object: 'object',

          // the properties below are optional
          enableDynamicFieldUpdate: false,
          includeDeletedRecords: false,
        },
        serviceNow: {
          object: 'object',
        },
        zendesk: {
          object: 'object',
        },
      },

      // the properties below are optional
      connectorProfileName: 'connectorProfileName',
      incrementalPullConfig: {
        datetimeTypeFieldName: 'datetimeTypeFieldName',
      },
    },
    tasks: [{
      sourceFields: ['sourceFields'],
      taskType: 'taskType',

      // the properties below are optional
      connectorOperator: {
        marketo: 'marketo',
        s3: 's3',
        salesforce: 'salesforce',
        serviceNow: 'serviceNow',
        zendesk: 'zendesk',
      },
      destinationField: 'destinationField',
      taskProperties: [{
        operatorPropertyKey: 'operatorPropertyKey',
        property: 'property',
      }],
    }],
    triggerConfig: {
      triggerType: 'triggerType',

      // the properties below are optional
      triggerProperties: {
        scheduled: {
          scheduleExpression: 'scheduleExpression',

          // the properties below are optional
          dataPullMode: 'dataPullMode',
          firstExecutionFrom: 123,
          scheduleEndTime: 123,
          scheduleOffset: 123,
          scheduleStartTime: 123,
          timezone: 'timezone',
        },
      },
    },

    // the properties below are optional
    description: 'description',
  },
  objectTypeName: 'objectTypeName',
  objectTypeNames: [{
    key: 'key',
    value: 'value',
  }],
  scope: 'scope',
  tags: [{
    key: 'key',
    value: 'value',
  }],
  uri: 'uri',
};
```

## Properties

- `domainName`: string (required) — The unique name of the domain.

- `eventTriggerNames`: string[] — A list of unique names for active event triggers associated with the integration.

- `flowDefinition`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnIntegration.FlowDefinitionProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_customerprofiles.CfnIntegration.FlowDefinitionProperty.html) — The configuration that controls how Customer Profiles retrieves data from the source.

- `objectTypeName`: string — The name of the profile object type mapping to use.

- `objectTypeNames`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnIntegration.ObjectTypeMappingProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_customerprofiles.CfnIntegration.ObjectTypeMappingProperty.html)[] — The object type mapping.

- `scope`: string — Scope of the integration, such as 'PROFILE' or 'DOMAIN'.

- `tags`: [CfnTag](/cdk/api/v2/docs/aws-cdk-lib.CfnTag.html)[] — The tags used to organize, track, or control access for this resource.

- `uri`: string — The URI of the S3 bucket or any other type of data source.