Skip to main content
POST
/
v1
/
organizations
/
me
/
{org_id}
/
applications
Create Application
curl --request POST \
  --url https://auth.contra.id/v1/organizations/me/{org_id}/applications
Multi-tenancy lives at the application level. Create one per environment (dev / staging / prod) or per customer.

​
Request

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"
  }'
BodyTypeRequiredDescription
namestringyesDisplay name.
environmentenumno"live" (default) · "test".

​
Response · 201

{
  "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.