---
title: "Register an additional email address"
method: POST
path: "/api/v1/me/emails"
tags: ["me"]
---

# Register an additional email address

`POST /api/v1/me/emails`

## Request

- Base URL: `https://composal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://composal.com/api/v1/me/emails`
- Auth: HTTP bearer

## Request body

- object
  - `email` string, email, required

## Response `200`

Email registered and verification sent

- AccountEmailsPage
  - `emails` AccountEmail[], required
    - `id` string, required
    - `email` string, email, required
    - `account` boolean, required
    - `commit_author` boolean, required
    - `verified` boolean, required
    - `verification_status` 'verified' | 'unverified', required
    - `can_delete` boolean, required
    - `can_set_account` boolean, required
    - `can_set_commit_author` boolean, required
    - `can_resend_verification` boolean, required
  - `message` string

## Other responses

- `201`: Email registered and verification sent
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `422`: Unprocessable entity
- `502`: Bad gateway

---

[API](https://skmtc.dev/composal/apis/vex-api.md) - [All operations](https://skmtc.dev/composal/apis/vex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/composal/apis/vex-api/revisions/74298a24e040?raw)