---
title: "Generate mailbox name suggestions for a sender"
method: POST
path: "/v1/domain/generate-mailbox-names"
tags: ["domain"]
---

# Generate mailbox name suggestions for a sender

`POST /v1/domain/generate-mailbox-names`

## Request

- Base URL: `https://developer.saleshandy.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.saleshandy.com/v1/domain/generate-mailbox-names`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/docs/v1/domain/generate-mailbox-names/post.ts> (a function with typed inputs; its response is checked against the schema)

Generate email address suggestions for a given sender name + domain.

Not required for purchase but used in the domain setup flow before <code>POST /v1/domain</code>. Suggested addresses follow patterns like <code>john.smith@</code>, <code>smithjohn@</code>, <code>jsmith@</code>.

<code>count</code>: min 1, max 100.

## Request body

- GenerateMailboxNamesDto
  - `firstName` string, required: Sender's first name.
  - `lastName` string, required: Sender's last name.
  - `domain` string, required: The domain to generate addresses for (e.g. "tryoutreachteam.com").
  - `count` number, required: Number of suggestions to return. Min 1, max 100.

## Response `201`

Mailbox names generated successfully

## Other responses

- `400`: 4000: Failed to generate mailbox names<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) - [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) - [OpenAPI document](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/revisions/e7a29c931aa7?raw)