# Onboard a Customer via Azure

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

**Prerequisites**:

* Partner API key and partner organization ID
* Contact your Archera representative if you don’t have these credentials
* Customer must have Azure subscription with billing access

**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: Generate Azure authentication URL <a href="#step-2-generate-azure-authentication-url" id="step-2-generate-azure-authentication-url"></a>

```shellscript
curl -X POST \
  -H 'x-api-key: YOUR_PARTNER_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "tenant_id": "customer-azure-tenant-id",
    "subscription_id": "customer-subscription-id"
  }' \
  https://api.archera.ai/v2/org/{child_org_id}/partners/onboarding/azure/auth-url
```

**Send the returned URL to your customer** to complete Azure authentication.

***

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

After customer completes authentication:

```shellscript
curl -X POST \
  -H 'x-api-key: YOUR_PARTNER_API_KEY' \
  https://api.archera.ai/v2/org/{child_org_id}/partners/onboarding/azure/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 Azure cloud integration** using OAuth authentication
* **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-azure.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.