---
title: "Create a new system domain from a referral code (That is associated to your domain)"
method: POST
path: "/v1/system_domains/referral_code/{referral_code}/"
---

# Create a new system domain from a referral code (That is associated to your domain)

`POST /v1/system_domains/referral_code/{referral_code}/`

## Request

- Base URL: `https://app.iconik.io/API/auth`
- URL: `https://app.iconik.io/API/auth/v1/system_domains/referral_code/{referral_code}/`
- Auth: none declared. Required headers: `App-ID`, `Auth-Token`
- TypeScript: <https://skmtc.dev/iconik/apis/iconik-auth/docs/v1/system_domains/referral_code/:referral_code/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `referral_code` string, required

## Headers

- `App-ID` string, required
- `Auth-Token` string, required

## Request body

- SystemDomainFromReferralCodeSchema
  - `admin_email` string
  - `admin_first_name` string
  - `admin_last_name` string
  - `admin_password` string
  - `billing_tier` 'PAYGO' | 'PRO' | 'ENTERPRISE' | 'ENTERPRISE_LEGACY_2025' | 'PRO_LEGACY_2025'
  - `country_code` string, required
  - `date_created` string, date-time
  - `date_modified` string, date-time
  - `description` string
  - `id` string, uuid
  - `name` string, required

## Response `201`

Returns a created system domain

- SystemDomainFromTemplateSchema
  - `admin_email` string
  - `admin_first_name` string
  - `admin_id` string, uuid
  - `admin_last_name` string
  - `admin_password` string
  - `base_url` string
  - `billing_tier` 'PAYGO' | 'PRO' | 'ENTERPRISE' | 'ENTERPRISE_LEGACY_2025' | 'PRO_LEGACY_2025'
  - `custom_terms` boolean
  - `date_created` string, date-time
  - `date_modified` string, date-time
  - `description` string
  - `disable_ai_features` boolean: Opt the new domain out of every AI feature.
  - `id` string, uuid
  - `name` string, required
  - `status` 'ACTIVE' | 'WARNING' | 'FROZEN' | 'DEACTIVATED'
  - `type` 'TRIAL' | 'CUSTOMER' | 'PARTNER' | 'INTERNAL'

## Other responses

- `400`: Bad request
- `401`: Token is invalid
- `403`: Permission denied
- `default`: Error response

---

[API](https://skmtc.dev/iconik/apis/iconik-auth.md) - [All operations](https://skmtc.dev/iconik/apis/iconik-auth/llms.txt) - [OpenAPI document](https://skmtc.dev/iconik/apis/iconik-auth/revisions/5dde985bb742?raw)