# Add domain to allowlist

Adds a domain to the federation allowlist. When domain allowlisting is enabled, only domains in this list can federate with the instance. Cannot add the instance's own domain.

RBAC: requires Federation.Manage

Endpoint: POST /api/v1/admin/domain-allow
Version: 1.0
Security: header

## Request fields (application/json):

  - `domain` (string, required)
    The domain name to add to the allowlist
    Example: "example.com"

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 409 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation


## Response 400 fields