# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.archera.ai/help-center/archera-embedded/onboard-a-customer-via-aws.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.