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

# Create Application

> Spin up a new application under your organization — each one gets its own api_key, webhook config, and billing scope.

Multi-tenancy lives at the application level. Create one per environment (`dev` / `staging` / `prod`) or per customer.

## Request

```bash theme={null}
curl -X POST https://auth.contra.id/v1/organizations/me/$ORG_ID/applications \
  -H "Authorization: Bearer $ACCESS_TOKEN" -H "Content-Type: application/json" \
  -d '{
    "name": "production",
    "environment": "live"
  }'
```

| Body          | Type   | Required | Description                      |
| ------------- | ------ | -------- | -------------------------------- |
| `name`        | string | **yes**  | Display name.                    |
| `environment` | enum   | no       | `"live"` *(default)* · `"test"`. |

## Response · 201

```json theme={null}
{
  "uuid":        "app_5b9c…",
  "client_id":   "cli_…",
  "api_key":     "ctr_…",
  "name":        "production",
  "environment": "live",
  "created_at":  1748566800
}
```

Each application is a **clean data + billing boundary** — sessions, workflows, webhooks, and credit usage are scoped to its `api_key`.