# Onboard a Customer via AWS

Use the Archera Partner API to programmatically onboard customers and set up AWS cloud integration.

**Prerequisites**:

* Partner API key and partner organization ID
* Contact your Archera representative if you don’t have these credentials

**Base URL:** `https://api.archera.ai/v2`

**Authentication:** Include `x-api-key: YOUR_PARTNER_API_KEY` header in all requests.

***

### ​Step 1: Register the customer organization <a href="#step-1-register-the-customer-organization" id="step-1-register-the-customer-organization"></a>

```shellscript
curl -X POST \
  -H 'x-api-key: YOUR_PARTNER_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "org_name": "Acme Corp",
    "org_email": "admin@acmecorp.com",
    "user_emails": ["admin@acmecorp.com"],
    "user_names": ["Admin User"]
  }' \
  https://api.archera.ai/v2/partners/{partner_org_id}/orgs
```

**Save from response:** `child_org_id`

***

### ​Step 2: Get AWS CloudFormation launch URL <a href="#step-2-get-aws-cloudformation-launch-url" id="step-2-get-aws-cloudformation-launch-url"></a>

```shellscript
curl -H 'x-api-key: YOUR_PARTNER_API_KEY' \
  https://api.archera.ai/v2/org/{child_org_id}/partners/onboarding/aws/launch-stack-url
```

**Send the returned URL to your customer** to deploy the CloudFormation stack in their AWS account.

***

### ​Step 3: Verify AWS integration <a href="#step-3-verify-aws-integration" id="step-3-verify-aws-integration"></a>

After customer deploys the stack:

```shellscript
curl -X POST \
  -H 'x-api-key: YOUR_PARTNER_API_KEY' \
  https://api.archera.ai/v2/org/{child_org_id}/partners/onboarding/aws/verify
```

**Check response:** All validations should return successful status.

***

### ​What You Can Do <a href="#what-you-can-do" id="what-you-can-do"></a>

The Archera Partner API enables you to:

* **Register customer organizations** under your partner account
* **Set up AWS cloud integration** using CloudFormation templates
* **Verify integration status** and data collection
* **Access commitment recommendations** for your customers
* **Execute purchases** on behalf of customers

This allows you to build Archera’s cost optimization capabilities directly into your platform.