---
title: "Add Email Forwarding"
method: POST
path: "/me/email-forwarding"
tags: ["me"]
---

# Add Email Forwarding

`POST /me/email-forwarding`

Request to add email address to user's forwarding list.

Sends a verification email with a confirmation link.
The email is not added to verified_emails until the link is clicked.

## Request body

- AddEmailForwardingRequest — Request to add email to forwarding list.
  - `email` string, email, required
  - `return_context` EmailVerificationReturnContext — Allowlisted navigation intent; never a login credential or arbitrary URL.
    - `destination` 'booking_import_email', required
    - `locale` 'en' | 'es'

## Response `200`

Successful Response

- AddEmailForwardingResponse — Response after requesting to add forwarding email.
  - `message` string, required
  - `email` string, required
  - `status` 'sent' | 'cooldown' | 'already_verified', required
  - `retry_after_seconds` integer

## Other responses

- `422` — Validation Error

## Changes

> 17 revisions in range; 1 not diffed.

- **2026-09-17** `74c5393c2f89` — 3 info
  - added the new optional request property `return_context`
  - added the optional property `retry_after_seconds` to the response with the `200` status
  - added the required property `status` to the response with the `200` status

[Change history](https://skmtc.dev/helloaxel/apis/client-api-gateway/changes/me/email-forwarding/post.md)

---

[API](https://skmtc.dev/helloaxel/apis/client-api-gateway.md) · [All operations](https://skmtc.dev/helloaxel/apis/client-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/helloaxel/apis/client-api-gateway/revisions/b7b1f6448378?raw)