> ## Documentation Index
> Fetch the complete documentation index at: https://docs.optimazehq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS

> Connect your AWS Cost and Usage Report so Optimaze can ingest cloud billing data.

Connect Amazon Web Services billing to Optimaze using your **Cost and Usage Report (CUR)** in S3. After you create the integration, deploy Optimaze CloudFormation stacks so Optimaze can assume a least-privilege IAM role and read billing data from your bucket.

## Prerequisites

* Access to the AWS account that owns your billing / CUR export
* A Cost and Usage Report delivered to an **S3 bucket** (bucket name and path)
* Permission to deploy **CloudFormation** stacks in the organisation or management account (and member accounts if required)

## Set up the AWS integration

In Optimaze, open **Integrations**, then choose **AWS** (or **Create** and select Amazon Web Services).

### Step 1: Enter account and billing details

Provide:

* **AWS Account ID**
* **Billing Report Type** (CUR, CUR2, or Focus)
* **S3 Bucket Name**
* **S3 path** (prefix where CUR objects are delivered)

These must match your AWS billing export configuration exactly.

![Image](https://mintcdn.com/optimaze/H22rTqPFmthmkajv/images/image-17.png?fit=max\&auto=format\&n=H22rTqPFmthmkajv\&q=85\&s=db002377457e2d1898af2966dd22a0a6)

### Step 2: Create the integration

Submit the form. Optimaze saves your configuration and provisions the integration.

![Image](https://mintcdn.com/optimaze/H22rTqPFmthmkajv/images/image-18.png?fit=max\&auto=format\&n=H22rTqPFmthmkajv\&q=85\&s=af53d8d056d5fd3347e7cb23fa7d5685)

### Step 3: Deploy IAM in AWS

When prompted, deploy the **CloudFormation** stacks Optimaze provides:

| Stack | Use when |
| :- | :- |
| **Organisation / management** | CUR ingestion from your billing account |
| **Member** | Optional discovery in linked member accounts |

Choose the **AWS Region** for stack launch, then use **Launch Stack** or download the YAML template. Confirm integration details (organisation ID, integration ID, Optimaze AWS account ID, bucket, and path) match what you entered.

![Screenshot 2026 07 14 At 4 25 09 Pm](https://mintcdn.com/optimaze/H22rTqPFmthmkajv/images/Screenshot-2026-07-14-at-4.25.09-pm.png?fit=max\&auto=format\&n=H22rTqPFmthmkajv\&q=85\&s=a70bfcfafcd2cbc1266537054d69aa64)

### Step 4: Checking setup

Optimaze verifies it can access your S3 bucket and read CUR data using the deployed IAM role. Fix any errors (wrong bucket path, stack failure, or missing permissions) and retry until validation succeeds.

## What happens next

Once validation succeeds, Optimaze syncs billing data from your CUR export into the platform for attribution, budgets, and FinOps reporting. Monitor health and last sync on the Integrations list.

## Data flow (summary)

Customer **Cost and Usage Report** in S3 → IAM role you deploy via CloudFormation → Optimaze reads CUR objects from your bucket → Optimaze internal storage and analytics. Optimaze does not require access to your application workloads.

## Troubleshooting

* **Wrong bucket or path:** Confirm S3 bucket name and prefix match the CUR delivery location in AWS.
* **CloudFormation failed:** Re-check stack events in the AWS console; ensure the Optimaze AWS account ID parameter is correct.
* **Access denied:** Verify the organisation and member stacks completed in every required account.
* **Integration error state:** Re-check account ID, billing report type, and bucket permissions, then retry from Integrations.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.