---
title: "Get mail client settings (hosted)"
method: GET
path: "/api/emails/{address}/client-settings"
tags: ["Email"]
---

# Get mail client settings (hosted)

`GET /api/emails/{address}/client-settings`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/emails/{address}/client-settings`
- Auth: HTTP bearer

Get IMAP/SMTP connection settings for a hosted mailbox, to configure Apple Mail, Thunderbird, or any mail client. Username is the full address; the password is an app password (create one with POST /api/emails/{address}/credentials). Hosted mailboxes only.

## Path parameters

- `address` string, required

## Response `200`

Client settings

- object
  - `mailbox` string
  - `username` string
  - `imap` object
    - `host` string
    - `port` integer
    - `security` string
  - `smtp` object
    - `host` string
    - `port` integer
    - `security` string
  - `hint` string

## Other responses

- `400`: Not a hosted mailbox

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)