---
title: "Create an app password (hosted)"
method: POST
path: "/api/emails/{address}/credentials"
tags: ["Email"]
---

# Create an app password (hosted)

`POST /api/emails/{address}/credentials`

## Request

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

Create an app password for a hosted mailbox, used as the password in a mail client (IMAP/SMTP). The secret is returned once - store it now. Hosted mailboxes only.

## Path parameters

- `address` string, required

## Request body

- object
  - `label` string: Label to identify this app password, e.g. "Laptop Mail"

## Response `201`

App password created (secret shown once)

- object
  - `id` string
  - `label` string
  - `password` string: The app password - shown once, store it now
  - `client_settings` object
  - `hint` string

## Other responses

- `403`: Email hosting not enabled for this account

---

[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)