# Push domains to another user

Push domains to another Unstoppable Domains user. Requires MFA (two-factor authentication) verification. The recipient must accept the transfer.

Endpoint: POST /mcp/v1/actions/ud_domain_push
Version: 1.0.0
Security: bearerAuth

## Request fields (application/json):

  - `domains` (array, required)
    Array of domain names to push (e.g., ["example.com", "mysite.io"])
    Example: ["example.com","mysite.io"]

  - `targetAccountId` (string, required)
    Recipient's account ID in format "adjective-noun-xxx" (e.g., "brave-tiger-k7m")
    Example: "brave-tiger-k7m"

  - `otpCode` (string, required)
    6-digit OTP code from your authenticator app
    Example: "123456"

## Response 200 fields (application/json):

  - `success` (boolean)
    Whether any domains were successfully pushed

  - `pushedDomains` (array)
    Domains that were successfully initiated for push

  - `failedDomains` (array)
    Domains that could not be pushed with reasons

  - `failedDomains.domain` (string)
    Domain name

  - `failedDomains.reason` (string)
    Reason the domain could not be pushed
    Enum: "not_owned", "not_dns", "pending_push", "expired", "ineligible"

  - `failedDomains.message` (string)
    Human-readable error message

  - `targetAccountId` (string)
    The target account ID

  - `message` (string)
    Human-readable summary message


## Response 401 fields