---
title: "Add hosting configuration (bulk)"
method: POST
path: "/mcp/v1/actions/ud_dns_hosting_add"
tags: ["DNS Management"]
---

# Add hosting configuration (bulk)

`POST /mcp/v1/actions/ud_dns_hosting_add`

## Request

- Base URL: `https://api.unstoppabledomains.com`
- URL: `https://api.unstoppabledomains.com/mcp/v1/actions/ud_dns_hosting_add`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/user-api/docs/mcp/v1/actions/ud_dns_hosting_add/post.ts> (a function with typed inputs; its response is checked against the schema)

Configure hosting for one or more domains: for-sale listing page, permanent redirect (301), temporary redirect (302), or reverse proxy. Supports up to 50 domains per request.

## Request body

- object
  - `domains` object[], required: Array of domain hosting configurations
    - `name` string, required: Domain name
    - `type` 'LISTING_PAGE' | 'REDIRECT_301' | 'REDIRECT_302' | 'REVERSE_PROXY', required: Hosting type
    - `targetUrl` string: Destination URL (required for REDIRECT_301, REDIRECT_302, REVERSE_PROXY)
    - `subName` string: Subdomain to configure
    - `forceCompatibility` boolean: Auto-configure UD nameservers if needed

## Response `200`

Bulk operation result

- BulkDnsOperationResponse: Response for bulk DNS operations (nameservers, hosting). Contains results per domain with success/failure tracking.
  - `results` object[]
    - `domain` string: Domain name
    - `success` boolean: Whether the operation succeeded
    - `operationId` string: Track with ud_domain_pending_operations (if successful)
    - `nameservers` string[]: Configured nameservers (for nameserver operations)
    - `hasDnssec` boolean: Whether DNSSEC is configured (for nameserver operations)
    - `config` object: Hosting config (for hosting operations)
      - `type` string
      - `subName` string, nullable
      - `targetUrl` string, nullable
    - `subName` string: Subdomain removed (for hosting remove operations)
    - `deletedAll` boolean: Whether all configs were removed (for hosting remove)
    - `error` string: Error message (if failed)
  - `successCount` number: Number of successful operations
  - `failureCount` number: Number of failed operations

## Other responses

- `401`: Authentication required

## Changes

- **2026-03-13** `d4c4c4b514bd`: 1 info
  - added the new `REVERSE_PROXY` enum value to the request property `domains/items/type`

[Operation history](https://skmtc.dev/unstoppabledomains/apis/user-api/changes/mcp/v1/actions/ud_dns_hosting_add/post.md)

---

[API](https://skmtc.dev/unstoppabledomains/apis/user-api.md) - [All operations](https://skmtc.dev/unstoppabledomains/apis/user-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unstoppabledomains/apis/user-api/revisions/c1def8e34b41?raw)