---
title: "Push domains to another user"
method: POST
path: "/mcp/v1/actions/ud_domain_push"
tags: ["Domain Management"]
---

# Push domains to another user

`POST /mcp/v1/actions/ud_domain_push`

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

## Request body

- object
  - `domains` string[], required — Array of domain names to push (e.g., ["example.com", "mysite.io"])
  - `targetAccountId` string, required — Recipient's account ID in format "adjective-noun-xxx" (e.g., "brave-tiger-k7m")
  - `otpCode` string, required — 6-digit OTP code from your authenticator app

## Response `200`

Push initiated

- PushDomainsResponse
  - `success` boolean — Whether any domains were successfully pushed
  - `pushedDomains` string[] — Domains that were successfully initiated for push
  - `failedDomains` object[] — Domains that could not be pushed with reasons
    - `domain` string — Domain name
    - `reason` 'not_owned' | 'not_dns' | 'pending_push' | 'expired' | 'ineligible' — Reason the domain could not be pushed
    - `message` string — Human-readable error message
  - `targetAccountId` string — The target account ID
  - `message` string — Human-readable summary message

## Other responses

- `401` — Authentication required

---

[API](https://skmtc.net/unstoppabledomains/apis/user-api.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/user-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/user-api/revisions/c1def8e34b41/schema)