---
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`

## Request

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

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.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)