Create mailbox

Create a mailbox under the given mail order. The full email address is composed from the given local part and the domain of the order.

Create mailbox

post

Create a mailbox under the given mail order. The full email address is composed from the given local part and the domain of the order.

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

orderIdstringRequired

Order resource ID

Example: OR1a2b3c4d5e6f7g

Body

local_partstring · max: 50Required

Local part of the mailbox address (the part before the @). The domain is taken from the order. Must start and end with a letter or digit; single dots, underscores and hyphens are allowed in between.

Example: john.doePattern: ^(?=[a-z0-9])(?=.*[a-z0-9]$)[a-z0-9_-]+(?:\.[a-z0-9_-]+)*$

passwordstring · password · min: 8 · max: 50Required

Mailbox password. Minimum 8 characters with uppercase, lowercase, number and special character.

Example: SecurePassword123!

Responses

201

Created response

application/json

idstringOptional

Mailbox resource ID

Example: AC1a2b3c4d5e6f7g

addressstringOptional

Email address of the mailbox

Example: [e-mail]

statusstring · enumOptional

Mailbox status

Example: activePossible values:

status_reasonstring · nullableOptional

Reason the mailbox was suspended

Example: abuse

is_catchallbooleanOptional

Whether the mailbox is the catch-all destination for its domain

Example: false

created_atstring · date-timeOptionalExample: 2025-03-01T10:00:00Z

updated_atstring · date-timeOptionalExample: 2026-07-20T14:30:00Z

401

Unauthenticated response

application/json

404

Error response

application/json

409

Error response

application/json

422

Error response

application/json

500

Error response

application/json

post/api/mail/v1/orders/{orderId}/mailboxes

POST /api/mail/v1/orders/{orderId}/mailboxes HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "local_part": "john.doe",
  "password": "SecurePassword123!"
}

{
  "id": "AC1a2b3c4d5e6f7g",
  "address": "[e-mail]",
  "status": "active",
  "status_reason": "abuse",
  "protocols": {
    "is_imap_enabled": true,
    "is_pop3_enabled": true,
    "is_smtp_in_enabled": true,
    "is_smtp_out_enabled": true
  },
  "counts": {
    "forwarders": 2,
    "aliases": 1,
    "autoreplies": 0
  },
  "is_catchall": false,
  "usage": {
    "storage_used": 512000,
    "storage_quota": 10485760,
    "messages_used": 1240,
    "messages_quota": 50000,
    "synced_at": "2026-07-22T08:12:00Z"
  },
  "created_at": "2025-03-01T10:00:00Z",
  "updated_at": "2026-07-20T14:30:00Z"
}