---
title: "Create a customer allowed domain for the enterprise portal"
method: POST
path: "/app/{app_id}/enterprise-portal/customer-allowed-domains"
tags: ["enterprisePortal"]
---

# Create a customer allowed domain for the enterprise portal

`POST /app/{app_id}/enterprise-portal/customer-allowed-domains`

## Request

- Base URL: `https://api.replicated.com/vendor/v3`
- URL: `https://api.replicated.com/vendor/v3/app/{app_id}/enterprise-portal/customer-allowed-domains`
- Auth: API key in header `Authorization`

Required RBAC Policy:
kots/app/[:appid]/enterprise-portal/customer-allowed-domains/create
kots/app/[:appid]/license/[:customer_id]/read

## Path parameters

- `app_id` string, required

## Request body

- object
  - `customer_id` string
  - `domain` string

## Response `201`

- object
  - `allowedDomain` AllowedDomain
    - `appId` string
    - `createdAt` string, date-time
    - `customerId` string
    - `domain` string
    - `id` string
    - `teamId` string

## Other responses

- `400`: Returned on bad input
- `401`: Return if the caller is not authorized
- `403`: Returned if the caller does not have the needed permission
- `404`: Returned on resource not found

---

[API](https://skmtc.dev/replicated/apis/vendor-api-v3-2.md) - [All operations](https://skmtc.dev/replicated/apis/vendor-api-v3-2/llms.txt) - [OpenAPI document](https://skmtc.dev/replicated/apis/vendor-api-v3-2/revisions/a36c6aead22f?raw)
