---
title: "Transfer domains"
method: POST
path: "/domains/transfer"
tags: ["Domains"]
---

# Transfer domains

`POST /domains/transfer`

## Request

- Base URL: `https://api.mailforge.ai/public`
- URL: `https://api.mailforge.ai/public/domains/transfer`
- Auth: API key in header `Authorization`

Initiates transfer of existing domains into the account. Response matches Infraforge (domains + optional invoice object). If every domain already exists in the workspace, no invoice is created (allDomainsAlreadyInWorkspace=true) and non-active domains are registered when possible.

## Request body

- ApiCreateDomainTransferRequest
  - `dmarcEmail` string
  - `domains` string[]
  - `forwardToDomain` string
  - `workspaceId` string

## Response `200`

OK

- MailforgeExternalApiDeliveryApiCreateDomainTransferResponse
  - `allDomainsAlreadyInWorkspace` boolean
  - `domains` MailforgeExternalApiDeliveryApiDomainResponse[]
    - `autoRenewFailedReason` string
    - `autoRenewLastProcessedExpiration` string
    - `autoRenewProcessedAt` string
    - `autoRenewStatus` 'disabled' | 'enabled' | 'failed'
    - `createdAt` string
    - `dmarcEmail` string
    - `expiresAt` string
    - `failedReason` string
    - `forwardToDomain` string
    - `id` string
    - `isTransferred` boolean
    - `mailDeletionAt` string
    - `mailServerId` integer
    - `nameservers` string[]
    - `priceCents` integer
    - `setupId` string
    - `sld` string
    - `status` 'draft' | 'active' | 'pending' | 'failed' | 'expired' | 'warning' | 'scheduled_for_deletion' | 'not_paid'
    - `tld` string
    - `type` 'v2'
    - `updatedAt` string
    - `workspaceId` string
  - `invoice` ApiPurchaseInvoiceResponse
    - `amountPaid` integer
    - `creditsApplied` integer
    - `id` string
    - `paidAt` string
    - `subTotal` integer
    - `total` integer

## Other responses

- `400`: Invalid request

---

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