---
title: "Create an email for a user"
method: POST
path: "/users/{id}/emails"
---

# Create an email for a user

`POST /users/{id}/emails`

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `address` string, email, required
  - `is_primary` boolean
  - `is_verified` boolean

## Response `201`

Created

- Email
  - `id` string, uuid4, required
  - `address` string, email, required — The email address
  - `is_verified` boolean, required — Indicated the email has been verified.
  - `is_primary` boolean, required — Indicates it's the primary email address.
  - `created_at` string, date-time, required — Time of creation of the email
  - `updated_at` string, date-time, required — Time of last update of the email

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `409` — Conflict
- `500` — Internal server error

---

[API](https://skmtc.net/hanko/apis/hanko-admin-api.md) · [All operations](https://skmtc.net/hanko/apis/hanko-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hanko/hanko-admin-api/versions/d22a127b0978/schema)