Assign prewarmed mailboxes

POST

/v2/prewarmed-domains/assign

This endpoint assigns pre-warmed domains to fill available slots in your pre-warmed subscription. When you assign domains, their mailboxes are automatically transferred to your account.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.zapmail.ai/api/v2/prewarmed-domains/assign' \
--header 'x-auth-zapmail;' \
--header 'x-workspace-key;' \
--header 'Content-Type: application/json' \
--data '"domainIds": [
      "8c0518b2-094e-4542-9702-b3b70a8f0839",
      "5e2f1a3c-6b7d-4e8f-9a0b-1c2d3e4f5a6b"
   ]'

Response Example

200 - Success

{
  "status": 200,
  "message": "Pre-warmed up mailboxes assigned successfully",
  "data": [
    {
      "id": "3f9c2a1e-7b4d-4e2a-9c3f-1a2b3c4d5e6f",
      "username": "jsmith",
      "firstName": "John",
      "lastName": "Smith",
      "domain": "globalcompanyshop.info"
    },
    {
      "id": "7d1e4f2b-8c5a-4b3d-9e6f-2b3c4d5e6f7a",
      "username": "amiller",
      "firstName": "Alice",
      "lastName": "Miller",
      "domain": "globalcompanyshop.info"
    },
    {
      "id": "9a2b3c4d-5e6f-4a1b-8c9d-3e4f5a6b7c8d",
      "username": "rjones",
      "firstName": "Robert",
      "lastName": "Jones",
      "domain": "globalcompanyshop.info"
    }
  ]
}

Modified at 2026-08-24 07:20:42

purchase prewarmed subscription

Get Available Domains Count