Amazon S3 integration

Amazon S3 is a cloud file storage service you can connect directly to Bloomreach for data imports and exports. The integration connects via the REST API and lets you choose the exact region and bucket where Bloomreach looks for files.

For imports and exports: regex file lookup, new file uploaded trigger, and selection rules for imports
For exports only: dynamic file naming

The integration also enables Adform retargeting.

Prerequisites

An Amazon AWS account with permission to create IAM users and manage S3 bucket policies.
Admin access to your Bloomreach project.

Set up the integration

Create the integration

Go to Data & Assets > Integrations.
Click Add new integration and select Amazon S3 for Imports or Amazon S3 for Exports.

Selecting Amazon S3 for Exports or Amazon S3 for Imports in the Integrations list.
Accept the terms and conditions and click Continue.

📘
Note
If you don't see the Integrations button, contact your access administrator to enable this function.

Generate access tokens

In AWS, create an access token with the permissions your use case requires:

Use case	Required permissions
Imports only	`s3:ListBucket`, `s3:GetObject`
Imports and exports	`s3:ListBucket`, `s3:GetObject`, `s3:PutObject`, `s3:DeleteObject`

Use the minimum permissions needed. You can configure these via the S3 console using bucket policies or Access Control Lists (ACLs).

📘
Note
If your S3 bucket policy restricts access by IP, add Bloomreach's outbound IPs as allowed source IPs in your bucket policy. You can configure this in the S3 console under Permissions > Bucket policy. Find your outbound IPs in Project settings > Security or Workspace settings > Security. See Outbound IP addresses for details.

Save your credentials

Save your Access key ID and Secret access key. You'll need these when configuring imports or exports.

🚧
Important
Keep your credentials secure. Don't share them, and store them somewhere your team can access if needed.

Use your integration

For imports

Go to Imports > Select a File storage integration.
Choose Amazon S3 and click the + sign to access your integration.

Supported formats: CSV, XML.

For exports

Go to Data Export >Select a File storage integration.
Choose Amazon S3 and click the + sign to access your integration.

Supported formats: CSV, JSON, JSON lines.

Use cases

Import scenarios

One-time imports: Import historical data or one-time campaign segments.
Regular imports: Sync with internal tools like your CRM.

Export scenarios

One-time exports: Export data for a specific time period.
Regular exports: Set up daily data exports.
Tool synchronization: Export data such as consents, events, or segments to internal or campaign tools.

Automated integrations

Adform integration: Export customers to custom audiences in Adform. Bloomreach handles this automatically.

Troubleshooting

Problem	What to check
Can't connect	Verify your Access Key ID and Secret Access Key are correct.
File format unsupported	Make sure your file is in a supported format.
File not found	Check the file is in the correct bucket and folder path
File not importing	Check the file is in a supported format, in the correct bucket and folder path.
File size	Large files may take longer to process or may need to be split into smaller chunks.
Permission errors	Check your IAM user has the right permissions for your bucket.
Wrong region	Double-check that you've selected the correct AWS region. Contact Bloomreach Support if you run S3 on a custom region.

Related resources

AWS S3 documentation: Visit Amazon's official S3 documentation for bucket setup help.