onboard a customer via azure.md

Onboard a Customer via Azure

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

Prerequisites:

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

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

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

After customer completes authentication:

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

The Archera Partner API enables you to:

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